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PREFACE 


This manual describes the 0OS/32 supervisor calls (SVCs) that 
provide the task interface to OS/32 system services. The 
information in this manual is intended for assembly language 
programmers who design application level programs for operation 
in an 08/32 processing environment. 


Chapter 1 presents an overview of all OS/32 SVCs, their functions 
and the data structure of the SVC parameter block. Chapter 2 
describes the Input/Output (I/0) Request SVC1l, which is used to 
request specific I/O services from the 0S/32 I/0 supervisor. 
This chapter also presents the SVCl interface to the Perkin-Elmer 
Series 3200 I/O Bus Switch Driver. Chapter 3 details 22 general 
service functions provided by the General Service Functions SVC2. 
Chapter 4 presents the format for the End of Task SVC3, which is 
used to terminate task execution. Chapter 5 provides information 
on user-controlled loading of Link-generated overlays through the 
Fetch Over lay svcs. Chapter 6 describes the _ Intertask 
Communications SVC6. Chapter 7 details the File Handling 
Services SVC7, which provides file and device handling functions 
supported by the file manager and the data communications 
subsystem. Chapter 8 describes how the Load Task Status Word 
(TSW) SVC9 is used to replace the current TSW located in the task 
control block (TCB) with a new user-specified TSW. Chapter 9 
provides information on the Overlay Loading SVC10, which handles 
the automatic loading of overlays generated by Link. Brief 
descriptions of the Auxiliary Processing Unit (APU) Control 
SVC13, User SVC14 and Data Communications Device-Dependent I[/0 
~SVC15 are given in Chapters 10, 11 and 12, respectively. 


Revision 02 includes additions to SVCl functions for the screen 
editor along with new status codes for SVCl device-dependent and 
device-independent status fields for Mirror Disk. This manual 
also introduces new SVCl extended functions to enable 8-bit data 
transfer, along with documentation of SVCl functions for the I/O 
Bus Switch Driver. Changes have been made to SVC7 dealing with 
3270 Emulator support and the Perkin-Elmer Series 7000 File 
Transfer Utility. Also, there are changes made to SVC7 access 
privileges. In addition, all SVCs previously documented in the 
System Level Programmer Reference Manual have been added to this 
manual. These additions include SVCO, SVC2. codes 0, 14, 26 and 
27, SVC6 System Task Release, various SVC7 functions and all of 
SVC13. 


This manual is intended for use with the 0OS/32 R0O7.2 software 
release or higher. 
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For information on the contents of all Perkin-Elmer 32-bit 
manuals, see the 32-Bit Systems User Documentation Summary. 
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CHAPTER 1 
SUPERVISOR CALLS (SVCs) 


1.1 INTRODUCTION 


OS/32 provides each task with the support it needs to perform its 
designated function. In addition to programs that allow a_ user 
to design, implement, test and execute tasks, OS/32 provides a 
number of system services that can be accessed by a task during 
execution. Included among these services are task timing, 
interrupt handling, input and output to devices or files, 
resource allocations and intertask communication and control. 


A task accesses a system resource by calling an OS/32 executor 
routine. An assembly program calls an executor routine by 
issuing an SVC. Table 1-1 lists the SVCs that access 0S/32 


system services for assembly tasks. These SVCs are divided into 
two groups: 


e sSvCs for general use in both application and system level 
programs, and 


e Svcs for use in system level programs only. 


TABLE 1-1 08/32 SVCs 


eee ree See I SES ED SUE MO EE GU SE a cD ee MS GRR GOR SEED Gee SUED SEED GRE Reet OS See Ge Ge GEE) Gee SD come Gee Ges Gok GERD Ws Gwe eee ee GO ae Geen On He ete Ome Oe ae ee ee ee ee Oe ee Oe ee oe oe 


H svc | FUNCTION H 
} BME MB IBRRUIRBBBBBEBEEEBAECEBESEERBSETBBVVBVABVSBEVBKCBAUABEVBABBsSEs { 
{ SVCO | User-written SVC | 
l 
{ SVvCl i} Input/output (1/0) request | 
| SVC2 code 0 =} Make journal entries i 
{| SVC2 code 1 | Pause 
| SVC2 code 2 j| Get storage 
{| SVC2 code 3 | Release storage | 
{ SVC2 code 4 | Set status ! 
{ SVC2 code 5 } Fetch pointer | 
i SVC2 code 6 | Convert binary to ASCII hexadecimal or 
| { ASCII decimal | 
{| SVC2 code 7 {| Log message ' 
{| SVC2 code 8 | Interrogate clock | 
{| SVC2 code 9 j Fetch date 
! SVC2 code 10 | Time of day wait { 
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TABLE 1-1 0OS/32 SVCs (Continued) 


SVC FUNCTION 


Interval wait 

Internal reader 

Convert ASCII hexadecimal or ASCII decimal 
to binary 

Pack file descriptor (fd) 

Scan mnemonic table © 

Move ASCII characters 

Peek 

Reserved for sequential tasking machines 
Reserved for sequential tasking machines 
Timer management 

Set accounting information 

Fetch accounting information 

Fetch device name 

Memory management 


SVC2 code ll 
SVC2 code 14 
SVC2 code 15 


1 

H 

{ 

H 

| 

| 

| SVC2 code 16 
| SVC2 code 17 
! SVC2 code 18 
' SVC2 code 19 
i} SVC2 code 20 
| SVC2 code 21 
i SVC2 code 23 
} SVC2 code 24 
| SVC2 code 25 
| SVC2 code 26 
| SVC2 code 27 
i SVC2 code 29 
| 

! 

H 

1 

{ 

i 

H 

H 

1 


H 
1 
i 
H 
SVC3 | End of task 
1 
! 
\ 
{ 
i 
{ 
| 
1 
t 
{ 
| 
H 
{ 


Unpack fd 
SVC5 Fetch overlay 
SVC6 Intertask communication and control 
SVC7 File handling services 
SVCc9 Load task status word (TSW) 
SVC10 Overlay loading 
SVC13 Auxiliary processing unit (APU) control 
SVC14 Function determined by user 
SVC15 Communications device-dependent I1/0 


Perkin-Elmer also provides run-time library (RTL) routines that 
allow a program written in FORTRAN or Pascal to access system 
services. These routines issue general user SVCs for the task. 
A system macro library is also available that allows an assembly 
program to issue an SVC through a system macro call. See the 
OS/32 Application Level Programmer Reference Manual for. an 
overview of the methods’ used by the application programmer to 
access system services. 
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1.1.1, Supervisor Call (SVC) Parameter Block 


Associated with each SVC (except SVC3) is an operating system. 


data structure called a parameter block. The parameter block 
contains the data required by the OS/32 executor. Each parameter 
block has a specific length and format. The full length of a 
parameter block must be reserved even if certain parameters are 
not required by the particular SVC executor routine. 


To issue an SVC, a task must specify the identifying number of 
the SVC and the address of the SVC parameter block as operands to 
the call. 


Format: 


Svc n,parblk 


Operands: 
n is a decimal number specifying the SVC. 
parblk is the label or address of the parameter block 


that contains the information necessary to 
execute the call. All parameter blocks must 
be fullword boundary-aligned. 


Execution of an SVC causes an interrupt that is processed by the 
Internal Interrupt Subsystem. See the 0OS/32 System Level 
Programmer Reference Manual for a description of SVC processing 
by the Internal Interrupt Subsystem. 


When building a parameter block structure, it is possible to use 
the standard symbolic names that have been assigned to the fields 
and functional values for the parameter block. To obtain these 


standard names and their definitions, expand the appropriate data. 


structure macro. These macros are contained in the 0S/32 System 
Macro Library Utility, SYSSTRUC.MLB. See the Common Assembly 
Language Macro/32 (CAL MACRO/32) Processor and OS/32 System Macro 
Library Utility Reference Manuals. 
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Use the following Macro Library Utility commands to 


SYSSTRUC.MLB directory: 


Use the following Macro 
desired 


*L, MLU32 
*ST 


PERKIN-ELMER OS/32 MACRO LIBRARY UTILITY 03-340 ROO-O1 


MLU >G MTM:SYSSTRUC.MLB/S 


MLU >DIR 
12/04/83 

$DCB$ $TCB$ 
$SVC1$  $ERRC$ 
$UREGS  $PSW 
$SVT $STE 
$VFDCB $SDCB 
$SDE $CTX 
$TOPT $TSTT 
$LIB $LOPT 
$ACB $FD 
$DATB $DFLG 
$SVC5 $SVC6 
$10B $ 1OBF 
$ESYS $EMIL 
$TQH $TC27 
$VFCHARS $HB 
$AOPT $TTB 
$LLE 


SFCBS$ 
$SVC13$ 


$LPMT 


$REGS$ 
$APB$ 
$SPTE 
$DDCB 
$SCV7SPL 
$TCB 
$TLFL 
$RLST 
$PFCB 
$SVC1l 
$SVC7EXT 
$SPOL 
SORT 

$QH 

$TKQ 
$SYP 


SETHSTCM $ETHDCBS $ETHSTBF 


$UDL$ 
$SOPT 
$$SPT 
$PSDCB 
$SD 
$OCB 
$TFL 
$RSARCPY 
$FCB 
$S1X0 
$SVC13 
$ATF 
$ODT 
$IPCB 
$APB 
SQPBS 


116 MACROS IN LIBRARY MTM:SYSSTRUC.MLB/G 


MLU > 


structure. 


Format: 


LIST fd,macro 


Library Utility 


$LIB$ 
$RREGS 
$TABLS 
$DDE 
$SPLMSG 
$PSTCB 
$TPRC 
$VD 
$FFLG 


$SVC1LERR 


$APST 
$GERC 
$SPR 
$IRCB 
$APRC 
$QPB 


command to 


display the 


$1OBS 
$EREGS 
$IVT 
$MAGDCB 
$TMQ 
$TSW 
$LTCB 
$DIR 
$CCB 
$SVC4 
$UDL 
$EFMG 
$TOE 
$ICB 
$APS 
$QPSTAT 


list the 
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Example: 


MLU > LI M300:MAR,§$SVC1l 
MACRO 
$SVC1L 
GBLB %SVC1l 
AIF ($SVC1) &SVC1xX 


%$SVC1 SETB 1 
SPACE 2 
SVCl. STRUC STRUCTURE OF SVC-1 PARAMETER BLOCK 
SPACE 1 
SVC1.FC DS 0 FUNCTION CODE 
SVC1.FUN DS 1 (ALTERNATE MNEMONIC) 
SVC1.LU DS 1 LOGICAL UNIT 
SVC1.STA DS l STATUS FIELD 
SVC1.DN DS 1 DEVICE NUMBER 
SPACE 1 
SVC1.SAD DS ADC BUFFER START ADDRESS 
SVC1.EAD DS ADC BUFFER END ADDRESS 
SVC1.RAD DS ADC RANDOM ADDRESS 
SVC1.LXF DS 4 LENGTH OF LAST TRANSFER 
ENDS 
SVC1X STRUC 
DS SVCl. 
SVC1.XIT DS 4 EXTENDED ITAM OPTION BITS 
ENDS 
SPACE 2 
oa a THE SVC-1 FUNCTION CODES 
SPACE 1 
SV1.CMDF EQU X'80' COMMAND 
SV1.READ EQU X'40' READ 
SV1.WRIT EQU X'20' WRITE 
SV1.BIN EQU x'10' BINARY 
SV1.WAIT EQU x'08' WAIT 
SV1.RAND EQU x'04' RANDOM 
SV1.UPRO EQU X'02' UNCONDITIONAL PROCEED 
SV1.IMG EQU x'ol' IMAGE MODE 
SV1.XIT EQU x'O1' ITAM EXTENDED OPT 
SPACE 1 
SV1.REW EQU x'co' REWIND 
SV1.BSR EQU X'AO' BACKSPACE RECORD 
SV1.FSR EQU x'90' FORWARD-SPACE RECORD 
SV1.WFM EQU X'88' WRITE FILE-MARK 
SV1.FFM EQU x'84' FORWARD-SPACE FILE-MARK 
SV1.BFM EQU X'82' ' BACKSPACE FILE-MARK 
SV1.DDF EQU x'81' DEVICE-DEPENDENT FUNCTION 
SPACE 1 
SV1.HLT EQU x'80' HALT I/O 
SV1.SET EQU x'60' TEST & SET 
SV1.WO EQU x'08' WAIT ONLY 
SV1.TEST EQU X'O2' TEST 1/0 COMPLETION 
SPACE 1 


RRR KKK KKK KKK KKK KKKKEKCKKKKKKKKKEKREKKEKRKEKEKKEKKEKEKEKKKKAKEKE 


&Svcix ANOP 

MEND 
1 MACRO LISTED TO M300:MAR 
MLU > 
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1.2 SUPERVISOR CALL (SVC) ERRORS 


The operating system informs the task of any error conditions 
encountered during SVC processing. Depending on the kind of 
error encountered, the operating system: 


@ pauses execution of the task and displays a message on the 
system console, or 
@e stores an error code in the error status field of the SVC 


parameter block and/or sets the condition code. 


The first method is used when an error condition occurs as a 
result of a programming error in the task code (e.g., alignment 


or illegal instruction fault). If the user wishes the task to 
handle these errors, the task can take a trap that causes 
execution to branch to the task trap-handling routine. See the 


0OS/32 Application Level Programmer Reference Manual for more 
information on trap-handling. 


The second method informs the user of the execution status of the 
SVC executor. 


1.2.1 Supervisor Call (SVC) Error Messages 


When the user chooses not to take a trap when an illegal 
instruction fault occurs, the illegal instruction trap bit is set 
to O in the current TSW. On encountering an SVC error, the 
operating system pauses the task and outputs a message to the 
system console. 


If the SVC error results from attempting to execute an undefined 


or illegal SVC or from specifying an invalid code for an SVC2, 
the following message is displayed: 


ILLEGAL SVC - INSTRUCTION AT xxxxxx(yyyyyy) 


Where: 
xXXXXX is the relative address of the SVC instruction 
that caused the error. 


YYYYYY is the physical address of the SVC instruction 
that caused the error. 
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If an address or alignment error occurs, the following message is 
displayed: 


Format: 


SVC ADDRESS ERROR - INSTRUCTION AT XXXXXX(YYYYYY ) 
SVC PARAMETER BLOCK AT xxxxxx(yyyyyy) 


Where: 
XXXXXX is the relative address of the SVC or 
parameter block that caused the error. 
YYYYYY is the physical address of the SVC or 


parameter block that caused the error. 


NOTE 


Systems equipped with a memory address 
translator (MAT) display the following 
message when an address or alignment 
error occurs: 


SVC ADDRESS ERROR-INSTRUCTION AT xxxxxx(yyyyyy ) 
SVC PARAMETER BILOCK AT xxxxxx(yyyyyy) 
MEMORY FAULT ADDRESS = xxxxxx(yyyyyy) 


An address or alignment error can result 
from any one of the following conditions: 


e The address’ specified for the SVC 
parameter block lies outside task 
boundaries. 


@e The address’) specified for the svc 
parameter block is not aligned ona 
fullword boundary. 


e® The address specified for the SVC 
parameter block is not within a 
writable segment, which is’ required 
for that particular SVC. 
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1.2.2 Supervisor Call (SVC) Status Codes 


When an SVC execution error occurs, the operating system: 


@e returns an error code to the status field of the SVC parameter 
block, and/or 

@e sets bits in the condition code (CVGL) to reflect the results 
of SVC execution. 


The status code returned depends on the particular SVC. Each SVC 


described in this manual has a defined set of status codes. The 
condition code (CC), if set for the SVC, depends on the 
particular SVC. Generally, a CC of O indicates’ successful 


execution and termination. 


A nonzero error code may be returned to the status field of the 
SVC parameter block as a result of one of the _ following 
conditions: 


e The buffer to which the SVC parameter block is pointing is not 
aligned on the proper boundary. 


@ An SVC parameter block that must point to a task-writable 
segment is pointing to a buffer outside a writable segment. 


To test the CC, use a branch mnemonic that tests for a true 
condition. 


Example: 


In the following example, the CC of the program status word (PSW) 
is tested for the conditions specified by the mask field PSW.CC. 
PSW.CC is equated to X'F'. If any conditions tested are found to 
be true, a branch is taken to the location ERROR. For more 
information on branch instructions, see the Instruction Set 
Reference Manual or the Processor User's Manual for’ the 
appropriate processor model. 


BTC PSW.CC,ERROR 


1-8 48-038 FOO RO2 


1.3 SVCO: USER-WRITTEN SUPERVISOR CALL (SVC) 


SvcoO is reserved for user-written OS/32 executor routines. 
Before writing an executor routine that can be called by SVCO, 
the operating system must be modified. This modification can be 
done dynamically at run-time by an executive task (e-task). 
However, the SVC executor table contains only halfword entries; 
the first instruction of the executor routine called by SVCO must 
lie within the first 64kb of physical memory. 
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CHAPTER 2 
INPUT/OUTPUT (1/0) REQUEST SUPERVISOR CALL 1 (SVC1) 


2.1 INTRODUCTION 


SVCl executes all general I/O data transfer requests and specific 
command function requests. General I/O data transfer requests 
refer to either a read or write operation. Before any data can 
be transferred, the user must specify whether it is a read or 
write, the address and length of the I/O buffer that will receive 
or send the data, and the logical unit (lu) assigned to the 
device or file to which the I/O is directed. These 
specifications are indicated through certain fields of the SVCL 
parameter block. 


When requesting a read or write operation, the user must describe 
the data being transferred and the environment during the 
transfer in the SVCl parameter block. For proper execution of a 
simple data transfer request, specify the: 


e structure of the file to or from which a record is being 
transferred (sequential or random), 


e form that the data is in when transferred (ASCII or binary, 
formatted or image mode), and 


e state that the calling task will be in during [/0 (I/0 
proceed, [/O wait or unconditional proceed). 


If the device is busy when the data request is made, the user 
must decide if task execution is to wait, whether to queue the 
request and proceed or whether to proceed and retry the I/O 
request later. Link specifies the maximum number of I/O requests 
that are to be queued at one time. The user also has the option 
to start I/O and continue task execution, then stop task 
execution until the I/O is completed. If the device is free and 
the user wants exclusive access to a record or file (any file 
type), the user should execute a test and set operation to inform 
other tasks that the record or file is being used. 
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Once the read or write operation is completed: 


e test for I/0 completion (check the condition code (CC), status 
fields and task queue, or execute a test I/O complete) and, if 
the status fields indicate that no error has occurred, 

@ check to verify that all of the specified data was actually 


transferred (check the length of the data transfer field in 
the SVCl parameter block). 


All testing and checking for I/O completion can be accomplished 
through the SVCl parameter block. 

Specific I/O command function requests that can be made through 
SVCl include: 

e Rewind 

@e Backspace or forward space record 

e@e Write filemark 

@e Backspace or forward space filemark 

e User-specified, driver-dependent functions (reserved) 

e Halt I[/0 

Before a command function request is issued, the desired command 
must be specified and the lu must be assigned to the device to 


which the command is directed. These specifications are 
indicated in the SVCl parameter block shown in Figure 2-1. 
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2.2 SUPERVISOR CALL 1 (SVC1) 


The SVCl parameter block must .be 24 bytes long, fullword 
boundary-aligned and located in a task-writable segment. 
Location within a writable segment is necessary so the status of 
an I/O request can be returned to the status fields of the 
parameter block. All fields in the parameter block are not 
required for every I/O request but must be reserved (see Figure 


ne meee ce RD Se ED tie ED OS CE OS US GN CoD eS ED Oe ee Gee SE EE ee ce SS OS Gees ES CD GS GD Gee es Get aoe mene See GE GOED Sine OT Gee nee mee eee Si OE Se Gee OD Oe Ge) Mee Ol ee a ee oe 


10(0) }1(¢1) 12(2) Device-— {|3(3) Device- | 
} Function code} lu i independent | dependent | 
| | | status H status { 
leieninuisieciin ce came ee per ore gaia ace ees aa ge 
14(4) | 
Buffer start address 
1) t 
5 ' 
GS aricia peice Sea ae eS cnn ae Ee a Ra ee cee el 
18(8) | 
| ‘Buffer end address 
t 

[Sn ee TOT CE Ae ee ORR eR a eee | 
| ! 
}12(C) 
i Random address H 
| | 
{ Genki ss esi ei em ss eee en ah as i ei ka see en ne Se late me“ ‘teen “Sts ca sm Sl a | 
116(10) | 
{ Length of data transfer 
| 
[SSS SS SSS SSS Saas eee ae ae Se ae ee 
{}20(14) { 
H Extended options 1 

SVC 1,parblk 

ALIGN 4 

parblk DB X'function code' 

DB X'lu' 

DS 2 bytes for status 

DC A(buffer start) 

DC A(buffer end) . 

DC 4 bytes for random address 

DS 4 bytes for length of data transfer 

DC Y'extended options' 


Figure 2-1 SVCl Parameter Block Format and Coding 
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Fields: 


Function 
code 


lu 


Device- 
independent 
status 


Device- 
dependent 
status 


Buffer start 
address 


Buffer end 
address 


Random 
address 


Length of 
Gata transfer 


Extended 
options 


is a l-byte field indicating whether a request 
is a data transfer or a command function, and 


the specific operation to be performed. Bit 
settings for data transfer requests are 
described in Table 2-1. Hexadecimal function 
codes for command function requests are 
defined in Table 2-2. 

is a l-byte field containing the logical unit 


currently assigned to the device to which an 
I/O request is directed. 


is a l-byte field receiving the execution 
status of an I/O request after completion. 
The status received is not directly related to 
the type of device used. 


is a l-byte field receiving the execution 
status of anI/O request after completion. 
The status received contains information 
unique to the type of device used. 

is a 4-byte field used only for data 
transfer requests and must contain the 
starting address of the I/O buffer that 


receives or sends the data being transferred. 


is a 4-byte field used only for data 
transfer requests and must contain the’ ending 
address of the I/0 buffer that receives or 
sends the data being transferred. 


is a 4-byte field containing the address 
of the logical record to be accessed for a 
Gata transfer request; a legal hexadecimal 


number must be specified in this field if bit 
5 of the function code is set to l. 
is a 4-byte field used only for data 


transfer requests. It receives the number of 
bytes actually transferred as a result of a 
data transfer request. If an error occurs 
during data transfer, this field is modified 
with indeterminate data. 


is a 4-byte field specifying device-dependent 
and device-independent extended functions that 
must be executed by the device when it is 
servicing a data transfer request. 
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2.2.1 Data Transfer Requests 


Figure 2-2 shows the function code format for data transfer 
requests, and Table 2-1 defines each function code bit position. 


Format. Access Extended 
Options 
Test Wait | Test I[/0 
and Set Only PORTE 
Se ee Rav a 
;O}RIWE fF F Fo 4 4 
Bits: 


Figure 2-2 Function Code Format for Data Transfer Requests 


TABLE 2-1 FUNCTION CODE BIT POSITIONS FOR DATA TRANSFER 
REQUESTS 


BIT 
POSITION | BIT NAME H BIT SETTING AND MEANING 


0 | Function code {| O = data transfer request. 
|} type . H 
Pc en ea a i ee ie 
\ 1 | Read |} 1 = read operation. (Bit 2 must 
be set to 0.) 
H Si si as Gee oo “Gs «sfc ens (SiS ass “ems sv cmc ein unease tans Seneca sims cms ‘cs Miser Sn) GO ee Shs memantine semen" eg 
H 2 | Write | 1 = write operation. (Bit 1 must 
be set to 0.) 
| tal ai eb a cs saints Seow “Snes ar er tv “Cceh cma ‘Sen lass ts ce Seas Ci cs! hs Si (Si aS Sl enna Ss “aa Se smc GG “il Sms Tose to 
1-2 Test. and set l= test if a specific record ina 


' 
! 
file is being used by another 
' task. 


ASCII | O = the internal data is in the 

| 7-bit ASCII character set and 

| is translated to an equivalent 
H character set appropriate for 

! 
{ 


the external device. 
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TABLE 2-1 FUNCTION CODE BIT POSITIONS FOR DATA TRANSFER 
REQUESTS (Continued) 


BIT i 
POSITION } BIT NAME H BIT SETTING AND MEANING 
3 i Binary i; 1 = the internal data is 8-bit 

| binary and will not be trans- 

H lated. If bit 3 is set and an 

H image I/O extended option is 

| specified, the internal data 

H byte (eight bits) is trans- 

{ ferred without translation. 

I/O proceed O = if the device is not busy, 
return control to the calling 
task after initiation of data 
transfer to the device. How- 
ever, if the device is busy, 
the request is queued and task 
execution continues. 


} 
i] 
1 
H 
{ 
t 
i 
Wait 1/0 i} 1 = stop task execution, initiate 
| data transfer to the device, 
and wait until the completion 
of 1/0. 
{ 
| 
Wait only } 1 = task execution stops and waits 
{ until the completion of all 
{ queued 1/0 proceed requests to 
1 the specified lu. When a wait 
H only request is issued, bit 4 
H is the only bit set in the 
H function code. 
Sequential 0 = access the next logical record. 
random 


i 
1 1 = access the logical record 

H specified by the hexadecimal 

H value in the random address 
field of the parameter block. 

{ The association of the hexa- 

H decimal values with the logi- 
{ cal record must be established 
| before the data transfer 

H occurs. 
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TABLE 2-1 FUNCTION CODE BIT POSITIONS FOR DATA TRANSFER 
REQUESTS (Continued) 


BIT H 
' 
' 


Conditional 
proceed 


O = after the 1/0 request is 
issued, put the task into a 
wait state if the requested 
device is busy and the total 
number of queued requests 
exceeds the maximum. Once the 
I/O request is completed, the 
task resumes execution. If 
the maximum number of queued 
requests is 1, a pending re- 
quest causes the task to be 
placed in a wait state. 


Unconditional 
proceed 


| 1 = any I/O request made to a de- 
H vice that is busy is rejected 
H if the total number of queued 
| requests exceeds the maximum, 
| and task execution continues. 
! 

' 


Test I/0 
complete 


1 = test to check for the comple- 
tion of 1/0 to a specified lu. 


If a previous 1/0 proceed 
request or queued I/O proceed 
request does exist, the CC is 
set to X'F'. However, if there 
is no outstanding I/O proceed 
request, the CC is set to X'O'. 


When a test 1/0 complete re- 
quest is issued, bit 6 is the 
only bit in the function code 
set. If bit 4 is set, it is 
ignored. 

Format } O = the data being transferred is 
| formatted as indicated by the 
H bit 3 setting of the function 
H code and according to the 

| device type specified. 
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TABLE 2-1 FUNCTION CODE BIT POSITIONS FOR DATA TRANSFER 
REQUESTS (Continued) 


BIT 


Extended / 
image options 


1 = tests the setting of the XSVClL 
task option. If XSVCl is off, 
an image I/O transfer is per- 
formed. If the option is on, 
the extended options fullword 
in the parameter block is 
checked for specified options. 


the data being transferred is 
in image mode and is not for- 
matted. In effect, the user 
must explicitly specify any 
control characters such as 
carriage returns (CRs) or line 
feeds (LFs) on writes and will 
receive exactly what is input 
on reads. 


' 
\ 
; 
{ 
H 
( 
! 
1 
i 
| When an image 1/0 is performed, 
i] 
: 
| 
H 
H 
H 
i] 
4 
H 
{ 
! 


2.2.1.1 Test and Set 


The test and set function can be used to write a program that 
prevents multiple tasks from modifying a record simultaneously. 
A task that issues an SVCl with the test and set bit enabled 
notifies other tasks that it is using a record by setting the 
first bit of that record to 1. This bit setting is called a 
l-bit record lock. Any task subsequently performing a test and 
set on the record is informed that the record is being accessed 
by another task. 


To use the test and set function, set both bits l1 and 2 of the 
function code field to l. If the test and set operation is used 
to lock out a record written in binary image mode, make certain 
that the first bit in the record is initially set to 0. In 
addition, the size of the user buffer should match the size of 
the file record. The following diagrams demonstrate how a test 
and set operation is performed. 
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In the first diagram, the calling task issued an SVCl with test 
and set enabled to read a record into its user buffer specified 
by the SVCl parameter block. Notice that the bit setting for the | 
record lock bit is 0, indicating that the record is not being 
used by another task. 


Record 
lock Record length 
bit 
mh eee” nan 
Recorq } ----- 2 Shea sens foes Se eye eal, ein tay ” 2 eS an ee ee 
on 10} | 
Disk = ----- Oe ee eee 
Bytes: 
0 99 255 
1 sector 
Record 
lock 
ae 
Record ~At - 2 e----- 
Transferred i; OF | 
to User eee 2 ¢----- 
Buffer Bytes: 
0 99 


After the record is read into the user buffer, the test and. set 
operation tests the record lock bit. If the bit is 0, the record 
lock bit in the user buffer is set to 1. The following diagram 
shows the record lock bit settings after the test operation is 
performed. 


Record 
lock 
a 
Record “St----. J------------------ Q b------------- 
on 10; | 
Disk ==<=<== os GER Gtentastllieatontantasentententententententontonien Q b------------- 
Bytes 
0 99 255 
Record 
lock 
ie 
User WSS ---a a= Q t------- 
Buffer } 1} 
ie eae ee 2 b------- 
Bytes 
0 99 
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After the record lock bit is tested, the SVCl test and set 
function sets the record lock bit on disk to 1 so that other 
tasks attempting to modify the record are notified that the 
record is in use. SVCl sets the record lock bit on disk by 
copying the contents of the user buffer to the record's original 
location on disk. In addition, SVCl sets the CC to X'O' and 
resets the record lock bit in the user buffer to 0. 


The following diagram shows the results of the completed test and 
set operation. 


Record 

lock 

ies 
Record “St----.Qo b---------------- Qo bnn-------- 
Returned {1} ' 
to Disk = =  ------ Qo bn-n-------------- Q be--------- 
with Bytes: 
Record 0 99 255 
Lock Bit 
Set 

Record 

lock 

ital 

ae a Q %-----+-+- 
User 10! 
Buffer  -----+-- 2 e------- 
with Bytes: 
Record 0 99 
Lock Bit 
Set to 0 


Condition Code: 


——<— ee oe ee ee a ee eS ee es ee 
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If the calling task had performed a test and set operation on a 
record that had a record lock bit setting of 1, the CC would be 
set to X'F'. The following diagram shows the record lock bit 
settings and CC resulting from this test and set operation. 


Record 

lock 

i 
Record “St----Q Ub--~-------------- Q b--------- 
on Disk : i1} i H 
With = === tl b--~-------------- Qo bower cen 
Record Bytes: 
Lock 0 99 255 
Bit Set 

Record 

lock 

ti 

I es QY b-~----- 
User il} 
Buffer 0 eee oy la ar 
with Bytes: 
Record 0 99 
Lock Bit 
Set to l 


oo ce A a A Ane OS oN oe a OS ES oS oe oe 


After a test and set operation, a record protection program 
checks the CC. If the CC is 0, the task can then proceed to 
modify the record. If the CC is X'F', the task should retry the 
test and set operation before attempting to modify the record. 


To unlock the record on disk, the task that set the record lock 
bit should write the record in its user buffer back into its 
original location on disk, whether or not the task modified the 
record. 
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If the size of the user buffer is less than the size of the 
record, the following occurs when the record in the user buffer 
is written back to disk: 


e If the record in the user buffer is written back to an indexed 
file, the remaining bytes of the record are filled with zeros. 


e If the record in the user buffer is written back to a 
contiguous nonbuffered indexed or extendable contiguous file, 
the last two bytes of the record are propagated to the right 
until the remaining bytes of the record are filled. 


The following diagram illustrates how a user buffer smaller than 
a 256-byte contiguous file record is returned to disk. Notice 
that the last two bytes of the record in the user buffer are 
propagated to the right to fill a 256-byte sector on disk. 


Record Last two bytes 
lock of record 
99-byte a | 
Record 
in ipppeaar ate ane pene 2 t apg Sao 
User }0} 14D] 50} 
Buffer = -------- 2 broccc---- 
Bytes 
0 99 
Recora Last two bytes 
Lock of record 
bit 
99-Byte | 
Record “SD----Q P5-=-== Meme meen enna b----------- 
Returned 10} 14D{/50;/4D{50/4D}/50;4D} {4D}50}4D}]50 
to Disk ------ Qo benn nnn nn een QQ beorr rr 
Bytes 
0 99 255 


The test and set operation can be executed as a wait I/O or I/O 
proceed request. Setting the CC during a test and set operation 
occurs only when wait I/O is specified. (Bit 4 of the function 
code is set to 1.) However, if an I/O proceed is requested (bit 
4 of the function code is set to 0), setting the CC is not useful 
because it could be changed at any time during task execution 
when data transfer and task execution take place concurrently. 
Therefore, check the record lock bit in the buffer to determine 
whether the record is currently being used. See the 0S/32 System 
Level Programmer Reference Manual for the devices supporting test 
and set. 
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The following sample program demonstrates how the 
function can be used to 
protection. 


test and set 
write a program that provides record 


Sample Program: 


x 
x TEST AND SET EXAMPLE 
x 
x PRIOR TO PROGRAM EXECUTION ASSIGN LU 1 AND LU 2 
x TO A TEXT FILE CREATED BY EDIT32. 
x 
x 
x LU 1 AND LU 2 SIMULATE ACCESS OF THE FILE BY TWO 
* TASKS. 
* 
TESTSET PROG TEST AND SET EXAMPLE 
ENTRY TESTSET 
TESTSET EQU * 
x 
LIS 1,0 SET UP FIRST RECORD NO. 
LOOP EQU * 
ST 1,PB1+I0.RECNU FOR LU 1 
ST 1,PB2+10.RECNU FOR LU 2 
* 
svc 1,PBl READ & TEST RECORD ON LU 1 
BZ CONTOS5 OK; RECORD IS NOT LOCKED 
PAUS ERROR; RECORD IS LOCKED; SHOULD BE FREE 
CONTO5 EQU) * 
LA 14,PB1 PB ADR FOR EOF TEST 
BAL 15,@IOERR CHECK FOR END-OF-FILE 
x 
x 
CONT10 EQU) * 
svc 1,PB2 READ AND TEST RECORD ON LU 2 
BM CONT20 OK;RECORD IS LOCKED 
PAUS ERROR; RECORD IS FREE; SHOULD BE LOCKED 
x 
x 
CONT20 EQU * 
L 2,B1s MANIPULATE RECORD DATA 
ST 2,B1S 
x WRITE RECORD BACK TO FLE AND UNLOCK IT 
SVC 1, PB3 
x 
* 
SVC 1, PB2 READ AND TEST RECORD ON LU 2 
BZ CONT30 OK; RECORD IS FREE 
PAUS ERROR; RECORD IS LOCKED; SHOULD BE FREE 
x 
x 
CONT30 EQU) * 
svc 1,PBl READ AND TEST RECORD ON LU 1 
BM CONT40 OK; RECORD IS LOCKED 
PAUS ERROR; RECORD IS FREE; SHOULD BE LOCKED 
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* 
x 


CONT40 EQU = 


L 3,B2S MANIPULATE RECORD DATE 
ST 3,B2S 
x WRITE RECORD BACK TO FILE AND UNLOCK IT 


WRITE LU=2,RECNUMB=(1) ,ADDR=B2S , ENDADDR=B2E 


AIS 1,1 INCREMENT RECORD COUNTER 
B LOOP DO NEXT RECORD UNTIL EOF 
x 
PBl IOPCB FUN=X'76',LU=1,ADDR=B1S , ENDADDR=B1E, RESTART=CONTOS5 
x 
* 
PB2 IOPCB FUN=X'76',LU=2,ADDR=B2S , ENDADDR=B2E 
x 
x 
PB3 IOPCB FUN=X'36',LU=1,ADDR=B1S , ENDADDR=B1E, RECNUMB=(1) 
x 
x 
ALIGN ADC 
B1s DS 80 BUFFER FOR LU 1 
BLE EQU) *-1 
x 
x 
B2sS DS 80 BUFFER FOR LU 2 
B2E EQU  *-1 
x 
x 
END 


2.2.1.2 Input/Output (1/0) Proceed 


An I/O proceed request is initiated when bit 4 of the _ function 
code is set to O and a read or write operation is specified. 


If the device is free when a data transfer request is made with 
I/O proceed specified, task execution and data transfer take 
place concurrently. When the I/O is completed, the status of the 
data transfer is returned to the status fields in the parameter 
block. An illegal function code or illegal lu causes the status 
to be returned to the status fields before data transfer starts, 
resulting in rejection of the I/O proceed request. Since task 
execution and data transfer take place concurrently, the task 
must check for the completion of I/O. There are five ways to 
check for I/O completion: 


@ Execute a test I/O complete operation. 


@e Monitor the status fields in the SVCl parameter block issuing 
the request. 
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@e Take a trap when I/O is completed and branch to a= service 
routine. 


@e Issue a wait I/O request to the device specified by the SVC1 
making the request. This function will stop task execution 
until I/O is completed. 


@ Queue I/O requests by specifying the IOBLOCK parameter of the 
Link OPTION command and issuing the wait only function. This 
will stop task execution until all queued requests to a 
specified device are completed. 


An SVCl I/O proceed request to an indexed file executes in a 
different manner than an I/O proceed to other file types or 
devices. See the OS/32 Application Level Programmer Reference 
Manual for more information on I/O operations to indexed files. 


2.2.1.3 Queuing Input/Output (1/0) Requests 


When SVCl issues an I/O proceed request to a device that is busy, 
the request is placed on the calling task's I/0 control block, 
and task execution continues. The request is serviced when the 
device is free. Normally, each task has only one I/O control 
block on which to queuve an I/O request. To queue more than one 
request, use the IOBLOCK parameter of the Link OPTION command to 
assign more blocks to the task. 


Format: 


b 
OPTION Jaatock-) 


Parameter: 


b is a decimal number from 1 to 65,535 
indicating the maximum number of I/O control 
blocks assigned to a task. Each I/0 control 
block can contain one queued I/O request. If 
this option is not specified by the user, Link 
automatically assigns one I/O control block to 
the task. 
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2.2.1.4 Conditional Proceed 


If the number of queued requests exceeds the maximum number of 
I/O blocks assigned to the task and bit 6 of the function code is 
set to 0, SVCl places the task in a wait state until one of the 
queued requests is serviced. Task execution resumes when the 
number of queued requests equals the maximum number set by Link. 


The number of I/O requests a task can issue before going into the 
wait state is determined by the formula: 


b + 1 + number of logical units assigned to task 


Parameter b is the number of I/0 control blocks assigned to the 
task. 


2.2.1.5 Unconditional Proceed 


To prevent the task from going into the wait state when the 
maximum number of requests specified by Link are queued, set bit 
6 of the function code to 1. This code allows the task to reject 
all I/O requests made to a busy device after the maximum number 
of requests are queued. When a request is rejected, a status of 
0 is sent to the device-independent status field, and the CC is 
set to X'F'. The user can retry the rejected I/O request during 
task execution. 


2.2.1.6 Wait Input/Output (1/0) 


To stop task execution during a read or write operation, use the 
wait I/O function. A wait I/O request is initiated when bit 4 of 
the function code is set to 1 and a read or write operation is 
specified. 


If the device is free when a data transfer request is made with 
wait I/O specified, task execution stops, I/O is initiated, and 
the task waits to resume until I/O is completed. Status of the 
Gata transfer is returned to the status fields when the I/O is 
completed. If the device is busy when a data transfer request is 
made with wait I/O specified, the request is queued and task 
execution is suspended until the queued request is serviced and 
I/O is completed. Task execution then resumes. 
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2.2.1.7 Wait Only 


A wait only request stops task execution until all I/0 proceed. 
requests to the specified lu (including queued requests) are 
completed. When the last queued I/0 proceed request is 
completed, task execution continues. The status of the last 
completed I/O proceed request is returned to the status field of 
its respective SVCl parameter block. 


To issue the wait only request, set the SVCl function code field 
to xX'O8' and the lu field to the appropriate device. A nonzero 
status code will be returned to the status field of the SVCl wait 
only parameter block if any of the following conditions occur: 


e The lu is illegal (code X'81"). 
e The lu is unassigned (code X'81'). 


e The wait only request is issued for a pseudo device without 
SVC interception (code X'CO'). 


2.2.2 Command Function Requests 


All command function requests and task execution take place 
concurrently. Queued requests are handled the same way as 
conditional proceed data transfer requests. When the I/0 is 
completed, the status of the command function is returned to the 
status fields in the parameter block. An illegal function code 
or illegal lu causes the _ status to be returned to the status 
fields before the command function starts. This results in 
rejection of the command function request. 


Since task execution and command function requests take place 
concurrently, the task must check for I/O completion. These 
three methods are used to check for I/O completion: 


@ Execute a test I/O complete operation. 


@ Monitor the status fields in the parameter block for the 
command function status to be returned. 


e Issue a wait only request to the device specified by the SVC1l 


making the request. This function stops task execution until 
I/O is completed. 


Table 2-2 defines the function codes for command function 
requests. 
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TABLE 2-2 FUNCTION CODES FOR COMMAND FUNCTION REQUESTS 


| FUNCTION 
CODE MEANING 


Rewind - A rewind operation is to occur on the 
specified lu. 


Backspace record - The device assigned to the lu is 
to backspace one record length. 

X'90' Forward space record - The device assigned to the 
lu is to move forward one record length. 

X'88' Write filemark —- A filemark is to be written at the 
current pointer position on the device assigned 

to the lu. 

X'84' Forward space filemark - The device assigned to the 
lu is to move forward past the next filemark to the 
beginning of the next file. 

X'82' Backspace filemark - The device assigned to the lu 
is to backspace to the previous filemark. For disk 
files, this positions the pointer to the beginning 
of the previous file. For magnetic tape files, the 
tape is positioned at the end of the previous file. 
X'8l1' No echoplex - The device chooses no echoplex for 

an image I/O and selects 8-bit no parity as an op- 
tion for SVCl I/O. By preceding an I/0 with an 
additional SVCl with a function code Y¥'10000 O000', 
no echoplex is set in the data control block. This 
applies to device 156 and 157 drivers. 


Halt I/O - Cancel all previous I/O proceed requests 
to the specified lu. 


2.2.2.1 Halt Input/Output (1/0) 


When a halt I/O request is issued, any previous I[/0 proceed 
requests, whether they are in progress or queued to the specified 
lu, are cancelled. When the I/O is terminated, the task that 
issued the I/O proceed request takes a trap (if enabled), the 
request is queued, and the status of the I/O operation (data 
transfer or command function) is returned to the status fields of 
the parameter block issuing the request. The time of actual 
termination is asynchronous to the time the halt I[/O is issued. 
The independent status codes are listed in Table 2-3 and the 
dependent status codes are listed in Table 2-4. 
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When an I/O request is issued to an lu and a previous I[/0 proceed 
request exists for that same lu, the second request and any 
subsequent requests to that lu cannot be serviced until the . 
previous I/O request is completed. By issuing a halt I[/0O 
request, the first I/O request is cancelled, allowing I[/0 
requests issued after the cancellation to be started on the 
device. 


If the IOBLOCK option was specified by Link and at least one 1/0 
request to a specified lu is queued, execution of a halt I/O 
request cancels any I/O to that specified lu already queued or in 
progress. See the OS/32 System Level Programmer Reference Manual 
for the devices supporting the halt I/O request. 


2.2.3 Logical Unit (lu) 


An lu is a decimal number ranging from 0 to 254. The highest lu 
number to which a task can be assigned is determined by the lu 


parameter of the Link OPTION cormand. After loading the task 
into memory, the lu should be assigned to a particular file or 
device through SVC7 or an ASSIGN command. If no actual [1/0 


operation is desired, the lu should be assigned to NULL:, causing 
a no-operation (no-op) to occur. 


2.2.4 Device-Independent Status 


Logical units provide device-independent I/O by causing all [/0O 
requests to be made directly to the lu and not to the device. 
The execution status of an I/O request that is independent of the 
physical characteristics of the device being used is returned to 
the device-independent status field of the parameter block (see 
Table 2-3). The data remaining in this field from a previous [/0O 
request is not modified until a subsequent [/0 is completed or an 
error occurs. 


TABLE 2-3 DEVICE-INDEPENDENT STATUS CODES 


<tc te RAT SOY SD AER TN Ae NRE EY TTS SA ND SS SOS SE ene SS GS SE eS EE Sew ee GD Nemes Ae OL US SRD ME OTE Su! Geum mets Re Sem RnR Ree SE ee See Re ee Re OR ee Se Ss Se ee Se ew ee 


| STATUS j} 
| CODE |} MEAN ING 
{ SesSsrSesSsSsessSsSsesesSsest sess S SS SSS SSS SS SSS SSS ESSEC STCS SCS SSS SSS SSS es ES oe we | 
{ X'CO' | Illegal function - An error is present in the func- | 
' tion code; the requested function is not supported 
| by the device or assigned access privilege or the { 
i | buffer transfer is too small. (When using tape, ! 
H | minimum buffer size is four bytes.) H 
{ X'AO' | Device unavailable - The device is either 


inoperative or not configured into the system. 
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TABLE 2-3 DEVICE-INDEPENDENT STATUS CODES (Continued) 


STATUS | 

CODE | MEAN ING 
x'90' | End of medium (EOM) - The I/O directed to the lu 
reached the physical end of the device; e.g., end of 
tape. During magnetic tape operations, this status 
can be combined with one of the next three status 
codes, yielding X'98', X'94' and X'92'. 


End of file (EOF) - The logical end of file 
specified by the assigned lu was reached. 


Unrecoverable error - An error occurred and the [I/O 
request, which terminates task execution, cannot be 
retried. 


Parity - An even or odd parity error occurred on a 
data transfer request. 


Recoverable error - The I/O request is recoverable 
and can be retried. A write request was issued to a 
write-protected device. 


No I/O currently being processed - If a halt I/0 
request is executed, this bit is set, indicating 
that no I/O is being processed at this time. 


Illegal or unassigned lu - The lu specified in the 
parameter block is either incorrect or was not 
previously assigned. 


Normal execution or successful I/O is completed, and 
no error occurred. 


a eet a Reem eae me SR SND ew SNE a) Macey SR SO eA re cee ems eee min a my Se ee tee SS SS Se ee eS eat me ms ee ey ee en es ee om ie eh ee Se ee ee ee 


' 
1 
l 
t 
1 
1; X'82' 
i 
1 
i 


2.2.5 Device-Dependent Status 


The execution status of an I/O request that is directly related 
to the unique characteristics of the device being used is 
returned to the device-dependent status field of the parameter 
block (see Table 2-4). The data remaining in this field froma 
previous 1/0 request is not modified until a _ subsequent I1/0 
request is completed or an error occurs. 
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TABLE 2-4 DEVICE-DEPENDENT STATUS CODES 


ee ee eee Soe ME eee ce See Ge coe: meme Gee Se ome meme Ger Mme et ems pes me ie meme mate. vee Mt Se eee crm OS mee ES tm EE ees me me, mee ee OO mes men eee ee me me ee ee ee en ee 


| STATUS | 
{| CODE | MEAN ING 
cee ee 8a Sas See see SEK SESE ee ESE Eee eee ! 
Der aoe pga ee MP Maren EN gage Wp gn Wh oe yess ! 
| X'85' | Exhausted retries on seeks - Seeks on disk devices } 
1 | have been retried the maximum number of times. 
{ { I 
' 1 ' 
; X'84! | Queued 1/0 terminated - A queued 1/0 request is H 
| terminated because a previous I/O request failed. jj} 
t { t 
' ' { 
| X'83' {| Device is write-protected - A write operation to a |} 
| | write-protected device occurred. 
{ ' i] 
’ $ ' 
; X'82! | Read/write time-out - A read or write time-out | 
| | condition occurred. | 
; X'8l1' | Terminated by halt 1/0 - I/O was terminated by a H 
| halt I/0 operation. 
} X'OO' {| Normal execution - I/O was completed and no error | 
{ occurred. 


Cee itent ann Ms Me Minas Mee Aa ee A ee ee ee ee ee ee ee ee 


2.2.6 Buffer Start/Buffer End Addresses 


The buffer start/buffer end addresses specify the buffer to be 
used for data transfer requests. The start address is the first 
byte in the buffer. The end address is the last byte in the 
buffer that is included in the transfer. 


Starting Ending 
address address 
ae Data buffer ce 
ak eo ot ee ee 22 I eed ae SS Uae AUTON Cr —_—= 
bo bo 
Ea Se ON Inve ad Oat fed ORE POINT MEE Pace Ea AE Re Pe er oa 00 monn no nnn ern nn eee 
Bytes 

0 79 


2.2.7 Extended Options 


If bit 7 of the function code is set to 1 and the xXSVCl_ option 
was specified at Link time, the options specified by the SVCL 
extended option field are executed. The extended options 
fullword format is dependent upon the device to which an I[/0 
request is directed. In general, there are two formats: one for 
nonmagnetic tape devices and one for magnetic tape devices. 
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2.2.7.1 Nonmagnetic Tape Devices 


If a device is supported by the data communications subsystem, 
the extended options provide device-dependent, communication-— 
dependent and device-independent features when a read or write 
operation is performed. 


Figure 2-3 illustrates the fullword format of the extended 
options field of the SVCl parameter block for devices supported 
by the communications subsystem. 


Function modifiers Extended functions 


Figure 2-3 Extended Options Fullword Format for Nonmagnetic Tape 
Devices 


Bits O through 15 are for general use in both local and remote 
communications. 


Bits 16 through 25 are used to expand a function's capability. 
For example, the write edit function can be expanded to write 
blinking by using a function modifier. 


Up to 64 device-dependent I/O functions can be specified by bits 
26 through 31. These extended functions are mutually exclusive; 
however, an [/O with multiple requests or operations can be 
performed. 


Table 2-5 describes the SVCl extended options that can be 
specified for both local and remote communications. See the 
OS/32 Basic Data Communications Reference Manual for a listing of 
device-dependent extended functions along with their applicable 
function modifiers. 
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TABLE 2-5 SVCl EXTENDED OPTIONS FOR LOCAL AND REMOTE 
COMMUN I CAT IONS 


BIT H ; 

| POSITION } BIT NAME H BIT SETTING AND MEANING 

H SSSSSEeSVeeCc sR RSS SEWwSS SAS ASSESS EBREUBTBUBAsS SSS SS SS SSS SV SSS cSt SS SV SST sss = 
0 | Connect (CON) | 1 = terminal manager answers a 
telephone ring on a dial-in 
line during a read or write 
line initialization sequence. 

| 


| Disconnect } 1 = terminal manager disconnects 

i (DCT) H from a switched line following 

| final data transfer. 

Image/format 0 = data being transmitted is in 

(IMG/FMT ) image mode and is not format- 
ted. 


| 1 = terminal manager performs 

H normal record buffering, 

H inserts or deletes line 

H control characters and 
recognizes appropriate data 
| format control characters on 
| transmitted data. 


| 1 = no characters will be echoed 
| on read. Specifies the state 
of input character echo. 

| Applies to each read request 
H only. 


Transparent 
mode 


} 1 = any nonprintable data will not 
H be translated by driver. 

| Specified the transparent 

| state for the read request. 

: Meaningful for a formatted 

i read only. 


Monitor read | 1 = any data input will be placed 
\ on driver type-ahead queue. 

i Specifies a read request is 

H not intended to get input 

H data. Illegal unless type- 

| ahead has been turned on. 
Break key and halt I/0 

| 
t 


terminates the request. 
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TABLE 2-5 SVCl EXTENDED OPTIONS FOR LOCAL AND REMOTE 
COMMUNICATIONS (Continued) 


BIT { 
POSITION } BIT NAME BIT SETTING AND MEANING 1 
SBE VrTsrSss3VTese2 22 SSB LCoS AFTER KGSKSREARARETARHAK SSS STK SS SS SSSST SS SSE SS SSSS= i 
6 | Read prompt | 1 = data being written from a H 
buffer. Specifies data is to | 
H be written from a buffer until | 
H a CR or buffer limit. Then H 
H read (without line formatting) | 
is to be performed. Meaning- | 
ful for formatted reads only. |} 


——— a ee a eS ee DO eG es ee ee es Se oe ee ee ee ee ce ee ee ee ee ee ee ee es ee ee ne ee ee eee ee ee es oe ee 


| Vertical } lL = requests VFC option for an 
| forms control | ASCII I/O operation. | 
| (VFC) | | 

' 


Bit check ; L = when set, the device-dependent | 
bits are checked. This option | 
H deals exclusively with mirror 
Gisk configurations. This bit | 
H is set in conjunction with | 
bits 16, 17, 19, 20 or 21. 
! 


eee ne ee ce ee oe ew oe eS ee ee ee oe ee ee ee ee ne ee ee ee ee ee we ee ee ee ee ee es we Se ee ee eee es ee ee ee ee ee oe 


Synchroniza- 
tion complete 


| lL = set when synchronization of 
H mirror disk is complete; it 1 
H clears the resynchronization 

in progress field in the DCB 

1 DXFL.REB. 
a a a Sr ee FS H 
Synchroniza- ; 1 = when set, data is read from H 
tion of data | the primary disk and written 1 
to the same sector on the se- | 
condary disk. (Pertains to 
H mirror disk configurations. ) I 
t 
t 


Mirror read i L = when set, data is read from H 
H the same position on both the | 
mirror disks into a double H 
1 size I/O buffer. 1 


2-24 48-038 FOO RO2 


TABLE 2-5 SVCl EXTENDED OPTIONS FOR LOCAL AND REMOTE 
COMMUNICATIONS (Continued) 


BIT 
POSITION | BIT NAME BIT SETTING AND MEANING 

20 | SWOP | 1 = when set, the primary and 
H secondary disks of a mirrored 
H pair are exchanged. The disk 
H that was the secondary disk 
H becomes the primary disk and 
! 


vice versa. Read operations 
are now performed on the new 
primary disk. 

| fae re ten Same see cre me em eS De ce mS ts en ms ee ent So nD GE ES GED SO OD ND ENS Cnty is and cam mh mmm ar onus Me anh meee ay DD mS com Oe SEED ee SE GEE one ED COED Oe SD GED SE Ome oo 
{ 1 = when set, the calling task is 

i notified when a read operation 
H fails on the primary disk. 
’ 
| 


(Pertains to mirror disk con- 
figurations.) 


2.2.7.2 Magnetic Tape Devices 
The extended options fullword format differs when I/O is being 
directed to a magnetic tape device. Figure 2-4 illustrates the 


fullword format of the extended options field of SVCl parameter 
blocks used for magnetic tape I/O operations. 


Extended function code 


Figure 2-4 Extended Options Fullword Format for Magnetic Tape 
I/O Operations 
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If the extended function code requires an additional parameter, 
the most significant bits (MSBs) (0 through 7) contain the 
parameter value. 


Bits 8 through 26 are not used during magnetic tape I/O 
operations. Bits 27 through 31 contain the extended function 
code that indicates the type of I/O operation to be performed. 
The extended function codes available for use in this field are 
dependent upon the standard function code setting in the SVC1l 
parameter block. Table 2-6 contains the extended function codes 
available when the standard function code bit setting indicates 
a control operation. 


TABLE 2-6 EXTENDED FUNCTION CODES FOR CONTROL OPERATIONS 


EXTENDED  } 
FUNCTION | 
CODE VALUE } OPERATION/EXPLANAT ION 


0 | Rewind and unload - The tape is rewound to its 
| beginning, then unloaded. Requires hardware 
| Support. 
J=6 | Reserved 
7 | Create a gap - The drive is instructed to erase a 
i; section of tape (approximately 3 to 3.5 inches) in 
{| the forward direction. 
8 | Read drive status - A task can read eight status 
| halfwords into the buffer space specified in the 
| SVCl parameter block. The status returned depends 
' on the type of drive in use. See the High 
| Performance Magnetic Tape System (HPMTS) 125 
| Programming Manual for a list of the status 
| halfwords. Requires hardware support. 
9 | Reserved 
10 Erase tape - Erases a variable length of tape, 


beginning at the current position. The length of 
tape erased is determined by the following formula: 


Length of Tape = Number of Bytes in User Buffer 


Erased mre een ne ee en ee 
Current Tape Density 
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TABLE 2-6 EXTENDED FUNCTION CODES FOR CONTROL OPERATIONS 
(Cont inued) 


ee ee te ee fe ee ee tee re tems ee ee ee cemen teee  e ee mee s  ee ce e e  me e e ney e mee me es ee meeee  me m ts e Oe s e  mes  ee  ee  ee e  e 


EXTENDED |} 
FUNCTION § | 
CODE VALUE | 


10 | The result is rounded up to a multiple of the 
(Continued) | length of a hardware gap (approximately 3 to 3.5 
i inches). The maximum number of bytes that can be 
| erased depends upon the tape density (see Table 
| 2-7). If an erase tape request exceeds the maximum 
| number of bytes for the current tape density, the 
| operating system will erase the maximum number of 
| bytes, then output a message indicating that the 
|; remaining bytes in the buffer were not erased. The 
;} erase tape function is illegal if the tape is at 
| load point. 
J 
! 
NOTE 
! 
| 
For device code 65, the current density 
is assumed to be 800 bits per inch (bpi). 
| If the current density for device code 65 
is 1600 bpi, the length of tape erased is 
| twice as long as requested. 
L1=31 | Reserved 


ERASED 


ee ee ee 


TAPE DENSITY (BPI) | NUMBER OF BYTES 


| ! 
| ! 
800 200,000 
| ! 
| ! 


! 
1,600 | 400,000 
6,250 1,000,000 


Table 2-8 contains the extended function code available when the 
standard function code bit setting indicates a data transfer 
operation. 
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TABLE 2-8 EXTENDED FUNCTION CODES FOR DATA TRANSFER 


OPERATIONS 


EXTENDED 
FUNCTION 
CODE VALUE 


OPERATION/EXPLANATION 


No extended functions - The bit settings of the 
standard function (byte 1 of the SVCl parameter 
block) are read and used to determine the oper- 
ation to be performed. 


Read backward - The tape drive reads previous 
records on a tape while the tape is moved 

in the backward (rewind) direction. The task 
buffer is filled, from start address to end ad- 
dress, with bytes in the order they are read; 
i.e., reverse. If an error occurs during a read 
backward operation, the magnetic tape drive 
performs retries on that operation up to a number 
of times corresponding to the value set in the 
system generation (sysgen) macro library. (The 
read bit of the SVCl function code should be 
set.) Requires hardware support. 


Gapless operation - The driver reads or writes 
multiple data buffers to or from magnetic tape 
with no interrecord buffer gaps, using only one 
SVCl. Gapless operation requires the use of a 
special SVCl parameter block. The read or write 
bit in this parameter block should be set. 
Gapless operation is explained in Section 2.3. 
Requires hardware support. 


Gapless operation with buffer transfer 

reporting - The driver reads or writes multiple 
data buffers to or from magnetic tape with no 
interrecorder gaps, using only one SVCl. The 
task receives a buffer gap each time the driver 
uses another buffer. Gapless operation requires 
the use of a special SVCl parameter block. The 
read or write bit in this parameter block should 
be set. Gapless operation is explained in 
Section 2.3. Requires hardware support. 
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TABLE 2-8 EXTENDED FUNCTION CODES FOR DATA TRANSFER 
OPERATIONS (Continued) 


en mee Ee SD Gs mee ee Se ee ee ee ee ee ee ee ems Sue men eee cme mune come ime ms ee me Se me mee we cre ee ee se ee en mee ee ees em es cee ee ee ee es 


EXTENDED 
FUNCTION 
CODE VALUE 


4 


t 
| 
H OPERATION/EXPLANAT ION 
| Read forward and ignore data transfer errors - 
| The tape drive reads from the tape and ignores 
} data transfer errors if encountered. If a data 
| transfer error occurs, the status halfword is 
} set to indicate normal completion of the read. 
| The position of the tape after the read is the 
i; Ssame as if no error had occurred. Since some 
| errors terminate data transfer, the user should 
| check the length of the data transfer field to 
| verify that all of the specified data was 
} actually read. (The read bit of the SVC1l 

| function code should be set.) 
| Read backward and ignore data transfer errors - 
} The tape drive reads previous records ona 
{| tape while the tape is moved in the backward 
| (rewind) direction and will ignore data errors, 
{| iff encountered. If a data error occurs, the 
| status halfword is set to indicate normal 
| completion of the read. The position of the 
|} tape after the read is the same as if no error 
| had occurred. Since some errors terminate data 
f 
: 
H 
{ 
( 
| 
I 


transfer, the user should check the length of 
data transfer field to verify that all of the 
specified data was actually read. The user 
buffer is filled, from start address to end 
address, with bytes in the order they are read; 
i.e., reverse. (The read bit of the SVCl 
function code should be set.) Requires hardware 
support. 
User control of retries for data transfer 
errors - If an error occurs during a data 
transfer operation, the magnetic tape drive 
will repeat the operation up to the number of 
retries specified by the user in the first byte 
of the extended options field. The maximum num- 
ber of retries that can be specified for a read 
operation is 255. The maximum number of retries 
that can be specified for a write operation 
is 45. (The read or write bit of the SVCl 
function code should be set.) 


ow aeew eee eee ew we ee we Se we Soe oe 
mes wee ee we we ww ee ww we ww ww oe 
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TABLE 2-8 EXTENDED FUNCTION CODES FOR DATA TRANSFER 
OPERATIONS (Continued) 


{ EXTENDED | 

i FUNCTION | 

{| CODE VALUE } OPERATION/EXPLANAT ION 

} 2 SS Se SS SS ee ee 2 2 2 2 ee Ss 2 SS 2 2 Se 2 2 2 
| . NOTE 

{ If extended function code 6 is not 

{ H specified, the number of retries de- 
faults to the value set in the sysgen 

macro library. 


{ Read backwards and allow user control of 

|} retries for data transfer errors - The tape 

{ drive reads previous records on a tape while 

| the tape is moved in the backward (rewind) 

| direction. The user buffer is filled, from 

| start address to end address, with bytes in the 
| order they are read; i.e., reverse. If an error 
| occurs, the magnetic tape drive repeats the 

| operation up to the number of retries specified 
| by the user in the first byte of the extended 

{ options field. The maximum number of retries 

; that can be specified is 255. (The read bit of 
i the SVCl function code should be set.) 


° 
Ww 
ee 
ya) 
® 
14) 
i) 
a 
< 
® 
OQ 


In both cases, extended function codes are mutually exclusive, 
that is, only one extended function code can be specified in a 
single SVCl. 


2.2.7.3 Device-Dependent Status Codes for Magnetic Tape 
Operations 


The device-dependent and device-independent status fields of the 
SVCl parameter block indicate the execution status of an I/O 
operation performed to a magnetic tape. Table 2-9 lists the 
status codes returned to these fields. Additional status codes 
for gapless I/O operations are listed in Table 2-12. A magnetic 
tape I/O operation ceases upon detection of most of these errors. 
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TABLE 


2-9 MAGNETIC TAPE DEVICE-DEPENDENT STATUS CODES 


et ee me ee rem SD ee em, ery rm cme em emt ten come mee cry me ees me es, re ae ee mem meme ee mi re meme cms ees mr ee me we es ee ey mee mre ee my ee ee ee ee ee ee ee 


CODE 


48-038 FOO 


MEAN ING 


Time-out - A read or write time-out condition oc- 
curred during data transfer. 


Device write-protected - A write, write filemark, 
create gap, or erase tape operation was attempted to 
a write-protected device. 


Maximum buffer size exceeded - The buffer for the 
erase tape control operation is too large. 


Retries exhausted - A read, read backward, or write 
operation was retried the maximum number of times. 


Time-out - A read, read backward, read drive status, 
write or write filemark time-out condition occurred. 


Read backward at load point - Load point was reached 
before a read backward operation terminated. 


Time-out - A read, read backward or write time-out 
condition occurred while waiting for a prior 
operation to be completed. 


Short read - The buffer specified was too small for 
the tape block. This status is supported only by 
the high performance tape systems. 


Bottom of tape/end of tape check malfunction - An 
error occurred during an attempt to position the 
tape to determine whether the beginning or end of 
tape was detected. 


Selector channel (SELCH) malfunction - The SELCH 
malfunctioned during a read, read backward or write 
operation. 


Retries exhausted for write filemark - A write 
filemark operation was retried the maximum number of 
times. 


Retry malfunction - An error occurred while attempt- 
ing to position the tape to retry a read, read back- 
ward, write or write filemark operation that 


nesuTres ina Eecover sore error. 


Device unavailable - tne device is either inopera- 
tive or not configured into the system. 
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TABLE 2-9 MAGNETIC TAPE DEVICE-DEPENDENT STATUS 
CODES (Continued) 


STATUS | 
CODE |} MEAN ING 
cooo Illegal function —- The function code indicated a 


data transfer operation, but neither the read nor 
write bit was set. 


The function code indicated a control operation, but 
none of the other bits in the function code were 
set. 


The function code indicated an extended control 
operation, but the extended SVCl task option was 
disabled. 


The requested function is not supported by the 
device or assigned access privileges. 


| 

H 

i 

{ 

I 

| 

H 

! 

U 

{| Illegal extended function code - an undefined 
| function, or a function not supported by the 
| Specified tape drive, was indicated. 

| 

! 

| 


The extended function code indicated a read 
operation, but the standard function code has the 
write bit set. 


Buffer size too small - the buffer for a read, read 
backward, or write operation was less than four 
bytes. The buffer for the read drive status was 
smaller than 16 bytes. 


Erase tape at load point - an erase tape operation 
was attempted when a tape was at load point. 


User retries too large - the maximum number of 
retries specified for a write operation was greater 
than 45. 
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2.3 GAPLESS INPUT/OUTPUT (I/0) OPERATIONS 


Data transfer operations in gapless mode consist of a task. 
reading or writing data to or from a magnetic tape with no 
interrecord gaps, using only one SVCl. A task can have only one 
ongoing gapless SVCl at atime. The format of a gapless mode 
SVCl parameter block differs from the standard SVCl_ parameter 
block. The gapless SVCl parameter block cannot be reused until 
the gapless operation has been completed. To perform a gapless 
I/O operation, the XSVCl Link option must be specified before an 
I/O request is issued. Then, the task must issue an SVCl call 
that specifies, among other things, a pair of buffer queues, the 
IN-QUEUE and the OUT-QUEUE. The driver takes buffers from the 
IN-QUEUE and returns used buffers to the OUT-QUEUE. The task 
processes the buffers from the OUT-QUEUE and returns’ these 
buffers to the IN-QUEUE for reuse by the driver. 


The use and reuse of buffers during gapless I/O enables an amount 
of data much greater than memory capacity to be transferred by 
breaking the data into smaller segments, then transferring these 
small segments of data sequentially. The gapless mode SVC1l 
parameter block can only be used for gapless I/O operations. 


2.3.1 Gapless Mode Supervisor Call 1 (SVCl) Parameter Block 
Format 


The gapless mode SVCl parameter block must be 24 bytes’ long, 
fullword boundary-aligned and located in a task-writable segment. 
Location within a task-writable segment is necessary so that the 
status of an I/O request can be returned to the status fields of 
the SVCl parameter block. Figure 2-5 presents the gapless mode 
SVCl parameter block and a coding example. 
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{0(0) Function 


ic 


12 


ode 


0(14) 


parblk 


1(1) {| 2(2) Device- {3(3) Device- | 

lu | independent | dependent |} 

status status 

Bs ca ccd acs a eet “eee ese see See cs Se a cee Se es me a Se cee es ee ns ee ee Se see a ee a es es ' 
| 

OUT-QUEVE start address 

! 

Be a ee Se ae ee tec : 
H 

IN-QUEUE start address 

‘ 

! 


a YS NS CD SL AO SD A SS SE SY SS Se SS a ee SD SS ee ee mene ae ome eee ED GN SE GED ee ee oe ey eee De ee 


w 
c 

rh 
rh 
@ 

Ry 

_— 
oO 

a 
Q 

ct 
a: 


i 
! 
Extended options 

1 
' 

1,parblk 

4 

X'function code' 

X'lu' 


Figure 2-5 


Fields: 


Function 


code 


2 bytes for status 

A (OUT-QUEUE buffer start address) 
A (IN-QUEUE buffer start address) 
4 bytes for buffer length 

4 bytes for length of last buffer 
Y'extended options' 


SVCl Gapless Mode Parameter Block Format and Coding 


is a l-byte fieid indicating that the request 
is a data transfer request. This field also 
specifies the operation to be performed (read 
or write) and the extended options pointer. 
Bit settings for this field are presented in 
Table 2-8. 
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lu 


Device- 
independent 
status 


Device- 
dependent 
status 


OUT-QUEUE 


IN-QUEUE 


Buffer length 


Length of 
last buffer 
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is a l-byte field containing the logical unit 
currently assigned to the device where the I/O 
request is directed. 


is a l-byte field receiving the execution 
status of an I/O request after completion. 
The status received is not directly related to 
the type of device used. Table 2-3 presents 
device-independent status codes. 


is a l-byte field receiving the execution 
status of a gapless I[/0 request after 
completion. The status received contains 
information unique to the type of device used. 
Table 2-11 presents device-dependent status 
codes for gapless operation. 


is a 4-byte field containing the fullword 
address of a queue where the driver places the 
starting address of each buffer used ina 


gapless I/O operation. If the operation is a 
gapless write, these buffers have been 
successfully written to tape. If the 


operation is a gapless' read, these buffers 
contain data read from the tape. 


is a 4-byte field containing the _ fullword 
address of a queue where the task places the 
starting address of each buffer to be used in 
a gapless I/O operation. If the operation is 
a gapless write, these buffers are written to 
tape. If the operation is a gapless read, 
these buffers are filled with data read off 
from a tape. 


is a 4-byte field containing the length of 
each buffer whose starting address is present 
on the IN-QUEUE. Buffer length must be an 
even number of bytes for both read and write 
operations. All buffers, except the last, 
must be the same length within a_e single 
gapless I/O operation. The amount of space 
used in the last buffer, however, can vary. 


is a 4-byte field whose contents depend upon 
the operation (read or write) being performed. 
If the operation is a gapless read, the driver 
fills this field with the length of the _ last 
buffer read off tape. The length of the last 
buffer can be optionally. supplied by the task. 
If the operation is a gapless write, the task 
supplies the driver with the length of the 
last buffer to be written. 


Extended is a 4-byte field containing one of two 

options possible extended function codes’ indicating 
gapless mode I/O. Table 2-12 presents the 
extended function codes available for gapless 
mode I/O. 


2.3.2 Standard Function Code Format - Gapless Mode 
Figure 2-6 shows the standard function code format for a gapless 


mode data transfer request, and Table 2-10 defines each function 
code bit setting. 


Extended 
Option 
wm, 
iO; Ri Ww i | { { i { 
Bits 


Figure 2-6 Function Code Format for Gapless Mode Data Transfer 
Requests 


TABLE 2-10 FUNCTION CODE BIT POSITIONS FOR GAPLESS MODE DATA 
TRANSFER REQUESTS 


| POSITION § } BIT NAME H BIT SETTING AND MEANING 
| SSS Se eS EE eS eee Sees | 
H 0 i Function code | O = data transfer request. Must | 
H | type { be set for gapless I/0 H 
operations. 
| wenn nnn nnn nnn nnn nnn nn nn nn nnn nnn en nn ne nnn n nena | 
1 ; Read { l = read operation. (Bit 2 
1 H must be set to 0.) 
[Passa SoS SSeS SSS eee ae ae ees eer ee aS ee er eee 
i 2 i} Write | 1 = write operation. (Bit 1 
H H must be set to 0.) 
asteteciatetastrtntatateteat etait atatete areetatet eter atadeieianaeietateieiaeaiaieaenaiatane | 


WwW 


Not used in H 
gapless mode H 
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TABLE 2-10 FUNCTION CODE BIT POSITIONS FOR GAPLESS MODE DATA 
TRANSFER REQUESTS (Continued) 


BIT H ’ 
POSITION § | BIT NAME | BIT SETTING AND MEANING 
4 | I/O proceed O = if the device is not busy, 
return control to the call- 
ing task after initiation 

of data transfer to the 

device. However, if the 

device is busy, the request 
is queued and task execu- 
tion continues. Suggested 
for gapless mode. 

Wait I/0 1 = stop task execution, ini- 
tiate data transfer to the 
device, and wait until the 
completion of I/O. 

Wait only 1 = task execution stops and 

waits until the completion 
of all queued 1/0 proceed 
requests to the specified 
lu. 


When a wait only request is 
issued, bit 4 is the only 
bit set in the function 
code. 

| Not used in H 

} gQGapless mode | 

Conditional | O = after the I/O request is 
proceed H issued, put the task into a 
i wait state if the requested 
H device is busy and the 

| total number of queued re- 
H quests exceed the maximum. 

| Once the 1/0 request is 
i] 

| 

H 

' 

t 

1 

5 


as ae ee ae ee eee ame ee ame eee wee ee ee ee see ee ee ee eee oe ee ee ee we Se ee ee 


completed, the task resumes 
execution. If the maximum 
number of queued requests 
is 1, a pending request 
causes the task to be 
placed in a wait state. 


—ew ame ames wees eee eee eee ee eee eee we oe ew 
—ae wee eee ame wee eee ee ee ee ee ee ee ee 
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TABLE 2-10 FUNCTION CODE BIT POSITIONS FOR GAPLESS MODE DATA 
TRANSFER REQUESTS (Continued) 


BIT H 

POSITION |} BIT NAME H BIT SETTING AND MEANING 

{| Unconditional { 1 = any I/O request made to a 
proceed device that is busy is re- 
jected if the total number 
of queued requests exceeds 
the maximum and task exec- 
ution continues. 


test to check for the com- 
pletion of I/O to a speci- 
fied lu. 


Test I/0 
complete 


re 
i] 


If a previous I/O proceed 
request or queued [I/O pro- 
ceed request does exist, 
the CC is set to X'F'. 
However, if there is no 
outstanding I/O proceed 
request, the CC is set to 
KO 


When a test I/O complete 
request is issued, bit 6 is 
the only bit in the func- 
tion code set. If bit 4 is 
set, it is ignored. 


| 1 = test to see if XSVCl 

H option was specified at 

H Link time. If set, the 

H extended options fullword 
H in the parameter block is 
H checked for specified gap- 
H less option. Both the 

| XSVCl1 option and this bit 
| must be set for gapless 

1 operation. 


2.3.3 Logical Unit (lu) 


An lu is a decimal number ranging from 0 to 254. The highest lu 
number to which a task can be assigned is determined by the Link 
OPTION command. After loading the task into memory, the lu must 
be assigned to a tape drive which supports gapless 1/0 (device 
codes 68-70) through SVC7 or an ASSIGN command. 


2-38 48-038 FOO RO2 


If no actual I/O operation is desired, the lu should be assigned 
to NULL:, causing a no-op to occur. 


2.3.4 Device-Independent Status Codes 


Logical units provide device-independent I/O by causing all I/O 
requests to be made directly to the lu and not to the device. 
The execution status of a gapless I/O request that is independent 
of the physical characteristics of the device being used is 
returned to the device-independent status field of the parameter 
block. See Table 2-3. The data remaining in this field from a 
previous I/O request is not modified until a subsequent I/O is 
completed or an error occurs. 


2.3.5 Device-Dependent Status Codes 


The device-dependent status field, together with the 
device-independent status field, indicates the execution status 
of a gapless I/O request that is directly related to the unique 
characteristics of the device being used. Tables 2-11 and 2-12 
present the error status codes for gapless operation. A _ gapless 
operation ceases upon detection of any one of these errors. 


TABLE 2-11 MAGNETIC TAPE DEVICE-DEPENDENT STATUS CODES 
(GAPLESS ONLY) 


ee ee ee ee et ee 


STATUS | 
CODE { MEAN ING 
X'8485' A read or write time-out condition 
occurred. 
X'8487' The end address read/written by the SELCH 
does not match the expected end address. 
X'8489' End address returned from SELCH is greater 


than the expected end address on gapless 
read. 


X'CO82' Address provided by the user on the IN- 
QUEUE is outside user's address space. 

X'CO83'! Address of a queue is not on a fullword 
boundary. 

Xx'CO84' Length of buffer is an odd number of 


bytes. Length of last buffer is an odd 
number of bytes for a write operation. 


| 
I 
! 
| 
| 
$ 
H 
' 
' 
H 
! 
! 
H 
\ 
X'CO81' | No buffer is available on the task IN-QUEUE. 
! 
| 


48-038 FOO RO2 2-39 


2.3.6 Buffer Queues 


The OUT-QUEUE field and IN-QUEUE field are each 4-byte fields 
that contain the address of a queue, where: 


@ The driver places the starting address of each buffer used in 
a gapless operation (OUT-QUEUE). 


@ The task places the starting address of each buffer to be used 
in a gapless operation (IN-QUEUE). 


The address of the IN-QUEUE must be greater than the address of 
the OUT-QUEUE or the SVCl handler rejects the operation. Figure 
2-7 presents the format of both the OUT-QUEUE and IN-QUEUE. 


The user sets up a queue via the DLIST xx command, where xx is 


the total number of buffer entries allowed. See the Common 
Assembly Language/32 (CAL/32) Reference Manual for instructions. 


10(0) 12(2) 
\ Number of slots | Number used ' 
t ] ! 
pal ce ee | 
14(4) 16(6) 
H Current top | Next bottom H 
1 1 1 
een ne ee te ree et Eee er oe ere eee ee ee | 
18(8) 19(9) 
' Flags H Address of first buffer i 
‘| 1 ! 
Sonera ee an Dee nero eae en OenE) Senne eee ee | 
112(C) 113(D) | 
Flags | Address of second buffer { 
) 1 t 
ee ea ee : 
116(10) 117(11) | 
Flags { Address of third buffer 
1 i] ! 
[ere ere te Serhan ee eevee ree ! 
L ng 
7 a 
i acs | 
Flags Address of nth buffer H 
{ t ! 
{ { 1 


Figure 2-7 IN-QUEUE or OUT-QUEUE Structure 
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Fields: 


Number of 


slots 


Number used 


Current top 


Next bottom 


Flags 


Address of 
nth buffer 
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is a standard list parameter that is explained 
in the Common Assembly Language/32 (CAL/32) 
Reference Manual. 


is a standard list parameter that is explained 
in the Common Assembly Language/32 (CAL/32) 
Reference Manual. 


is a standard list parameter that is explained 
in the Common Assembly Language/32 (CAL/32) 
Reference Manual. 


is a standard list parameter that is explained 
in the Common Assembly Language/32 (CAL/32) 
Reference Manual. 


is a l-byte field. The setting of bit O in 
this field identifies whether the buffer is 
the last buffer in the list. If bit 0 is set 
to 0, the buffer is not the last buffer. If 
bit 0 is set to 1, the buffer is the last 
buffer in. the queue. Under abnormal 
conditions, the last buffer on the OUT-QUEUE 
may not have the flag bit set. 


NOTE 


To properly terminate a gapless 
write operation, the flags field 
for the address of the last buffer 
to be written should have bit 0 
set to 1. But a gapless' read 
operation can be terminated in two 
ways. If the user wishes to read 
only part of a record or the user 
knows how long the record is, the 
flags field for the address of the 
last buffer read should have bit 
0 set to l. If the user wishes to 
read the entire record but does 
not know how long it is, the flags 
field for the address of all 
buffers should have bit O set to 
O. In this case, it is mandatory 
for the user to retain buffers on 
the IN-QUEUE until the I/O proceed 
has been completed. If exactly 
the number of buffers needed is 
placed on the IN-QUEUE, the _ last 
buffer must be so indicated. 


is a 3-byte field containing the hexadecimal 
starting address of a buffer. 


2.3.6.1 Using the Buffer Queue 


Gapless operations should be specified as I/O proceed completion 
operations; therefore, task execution can continue during gapless 
I/O. One of the functions a task can perform during gapless I/O 
is to prevent the task from running out of buffer space. The 
task can accomplish this by removing buffer entries from the 
OUT-QUEUE and placing them on the IN-QUEUE after a_ buffer 
transfer is completed. For example, if a task is required to 
write 440kb in gapless mode using only five 64kb buffers, the 
total buffer space available is 320kb (or 120kb less than is 
required to complete the write operation). After the first 
buffer has been written, the starting address of the buffer is 
placed on the OUT-QUEUE. While the second buffer is being 
written, the task can transfer the address of the first buffer 
from the OUT-QUEUE to the IN-QUEUE. This gives the task 64kb 
more buffer space. 


Similarly, the task can transfer the address of the second buffer 
to the IN-QUEUE while the third buffer is being read. This 
transfer provides the task with enough buffer space for the 
remaining 56kb. Note that when the task transfers the address of 
the second buffer from the OUT-QUEUE to the IN-QUEUE, bit 0 of 
the flags field should be set tol. The length of the last 
buffer should be placed in the length of last buffer field of the 
SVCl parameter block prior to the start of the operation. 


The task should use an add to the bottom of the list (ABL) 
instruction to add buffer entries to the IN-QUEUE and a run-time 
library (RTL) instruction to remove buffer entries from the 
OUT-QUEUE. See the Common Assembly Language/32 (CAL/32) 
Reference Manual for more information on how to use the ABL and 
RTL instructions. 


2.3.6.2 Trap-Causing Events Resulting from Gapless' Input/Output 
(1/0) Operations 


Because a gapless I/O operation should be specified as an I/O 
proceed completion operation, the task can be notified that a 
gapless read or write has been completed via a task queue trap. 
If the SVCl extended function code 3 (gapless I/O with buffer 
transfer reporting) has been specified, the task can also receive 
a task queue trap each time a buffer address has been added to 
the OUT-QUEUE. 


Before a task can be notified of gapless I/0 completion or a 
buffer transfer, the task has to be prepared to receive and 
handle a task queue handle trap. See the OS/32 Application Level 
Programmer Reference Manual for information on preparing a task 
to handle traps. 
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2.3.7 Buffer Length 


The buffer length field is given to the driver by the task to. 
inform the driver of the length of the buffers whose starting 
addresses are on the IN-QUEUE. Buffer length must equal an even 
number of bytes for both read and write operations. All buffers 
must be of the same length with the possible exception of the 
last buffer (see Section 2.3.8). 


2.3.8 Length of Last Buffer 


The use of this field is dependent upon the gapless I/O operation 
being performed (read or write). The length of this buffer 
cannot be greater than that of the other buffers. If a gapless 
write operation is being performed, this field is given to the 
driver by the task and contains the length of the last buffer to 
be written. This information must be given even if the _ last 
buffer is the same length as the previous buffers and should be 
placed in the SVCl parameter block before the write is started. 


On a gapless read operation, the driver fills this field with the 
length of the last buffer read from the tape. For example, if a 
150kb record is to be read gapless from a tape and 64kb buffers 
are used, a total of three buffers is required. The first two 
buffers contains 128kb of information; however, the third buffer 
contains only 22kb of information. The value 22kb is returned to 
the length of last buffer field in this example. If desired, 
this field can be given to the driver by the task. If the last 
buffer is specified for a read (i.e., the flags field of the 
address has bit O set to 1), this field must be given to the 
driver by the task. 


NOTE 


If a gapless read does not reach normal 
completion (status code 0), the contents 
of the length of last buffer field are 
meaningless. 


On a gapless write operation, the length of the last buffer must 
be an even number of bytes. 


2.3.9 Extended Options Field 
The extended options field in a gapless mode SVCl parameter block 
functions as detailed previously in Section 2.2.7. However, only 


two extended function codes are recognized as valid in a gapless 
mode SVCl. These codes are presented in Table 2-12. 
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TABLE 2-12 EXTENDED FUNCTION CODES FOR 
GAPLESS I/O OPERATION 


| EXTENDED | H 
| FUNCTION | 
H CODE H OPERATION 
| SSS Se SSS SS SS SSS SEES ESSE EE SESE SESS es | 
2 | Gapless operation 
t { { 
| ! ' 
{ 3 | Gapless operation with { 
| | | 


buffer transfer reporting 


Codes 0 through 1 and 4 through 31 are not used with the gapless 
mode SVCl parameter block. 


2.4 SERIES 3200 INPUT/OUTPUT (1/0) BUS SWITCH 


The Perkin-Elmer Series 3200 I/O Bus Switch Driver (device code 
143) provides software control of the I/O bus switch hardware. 
This switch allows the sharing of I/O devices by two or more 
Series 3200 Processors equipped with a multiplexor (MUX) and/or 
a SELCH bus. It may also be used as a bus’ extender. The bus 
switch hardware must be strapped for programmable mode. 
Strapping options are available for normal request, master 
request or multiple master request contention modes. 


2.4.1 Normal Request Contention Mode 


In the normal request contention mode, any central processing 
unit (CPU) in the configuration can issue a request for the 
services of the common bus. If the common bus is idle, control 
is immediately granted to the requesting CPU. If the common bus 
is in use (controlled by another CPU in the configuration) the 
request is queued until the controlling CPU relinquishes the bus. 


2.4.2 Master Request Contention Mode 

In the master request contention mode, one CPU may be designated 
as the master CPU. When this CPU issues a master request, it is 
immediately granted control regardless of the state of the bus. 
2.4.3 Multiple Master Request Contention Mode 


In the multiple master request mode, several or all of the CPUs 
in the configuration may issue a master request. 
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10(0) 
H Function | 
H code } 
| ans class ms Tale ohteioe Oe eke en su ci ini Sa 
14(4) 
i eas "cas Tea tia 
18(8) 
H cs ei in etc“) ld Nes 
{12(C) 
Svc 
ALIGN 
parblk DB 
DB 
DS 
DCF 
DCF 


16) 
ct 
ry) 
ct 
Cc 
m 


Reserved 


1,parblk 


4 

X'function code' 

X' lu! 

2 bytes for status 
y'oo',Yy'OoOo' 
X'Time-out constant' 


Figure 2-8 SVCl Parameter Block and Coding 


Fields: 


Function 
code 


lu 


Status 
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for Control of I/O Bus Switch 


is a 1-byte field indicating the switch 
operation to be performed. Hexadecimal 
function codes’ for bus switch operations are 


described in Table 2-13. 


is a l-byte field containing the logical unit 
to which the bus switch is currently assigned. 


is a 2-byte field. The first byte receives 
the execution status of the switching request. 
The second receives the hardware status of the 
switch. Table 2-14 describes the hexadecimal 
constants returned to this field. 


Reserved 


Time-out 
constant 


is an 8-byte field that must contain zeros. 


is a hexadecimal value ranging from X'l1' to 
X'7FFE' specifying the time-out delay in 


seconds. The driver waits the indicated 
number of seconds for connection before 
time-out. This field is required only for 


MASTER CONNECT, CONNECT and CLEAR requests. 


Table 2-13 defines the function codes for I/O bus switch command 
function requests. 


TABLE 


2 


-13 FUNCTION CODES FOR THE I/O BUS SWITCH DRIVER 


FUNCTION 
CODE 


X'4x'! 


X'3x' 


X'2x' 


MASTER CONNECT - If the switch is strapped for the 
master or multiple master options, the processor 
issuing this command is granted control of the 
common bus, provided another processor does not 
control the bus via a MASTER CONNECT. Any active 
normal connection is immediately disconnected and 
all queued normal CONNECT requests are cleared. 
The value of x determines whether the call is a 


WAIT, 


For possible values of x, see Table 2-1. 


CONNECT - is the normal request/contention 
sequence. If the common bus is idle, the processor 
issuing this command is immediately granted 
control. If the bus is busy, the CONNECT request 
is queued. The value of the random field of the 
SVCl parameter block is used to specify the number 
of seconds the driver is to wait for connections 
before time-out. The default is three seconds. 
The value of x determines whether the call is 


WAIT, 


possible values of x, see Table 2-1. 


CLEAR - activates the common bus system clear 
(SCLRO). This command causes all interfaces on 
the common bus to be reset. The value of x 
determines whether the call is WAIT, PROCEED or 
UNCONDITIONAL PROCEED. For possible values of x, 
see Table 2-1. 


ENABLE - This command enables interrupts on the 
common bus. 


MEAN ING 


PROCEED or UNCONDITIONAL PROCEED. 


PROCEED or UNCONDITIONAL PROCEED. For 
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TABLE 2-13 FUNCTION CODES FOR THE I/O BUS SWITCH DRIVER 


(Cont inued ) 
| FUNCTION |; . 
CODE MEAN ING 
i Sse SSS SEBS EE SPESK SCS VS SP SST SESS SSS SSE RCKESSSE ES SEABSLSSBTSP SS SS ETE FTS SS STFS Te cS ST = 
X'AO' {| DISABLE - This command prevents interrupts on the 
H } common bus. Interrupts are queued, but not 
1 | serviced while this command is in effect. 
! ' 
1 | 
H X'84' {| DISARM - prevents the queuing and servicing of 
| interrupts on the common bus. 
| | 
H x'88' | DISCONNECT - disconnects the common bus from the 
H } controlling processors. Once disconnected, the 
i } common bus is available to all processors. 
! { 
' ' 
H x'90! | RETURN STATUS - returns the hardware status of the 
H | bus switch to the second byte of the device- 
; Qependent status halfword of the SVCl parameter 
| } block. The only operation performed by this 
1 } command is a sense status of the switch hardware. 
H | The state of the switch is not altered. 
TABLE 2-14 1/0 BUS SWITCH STATUS CODES 
STATUS | 
CODE H MEAN ING 
X'OOnn' | Normal completion of requested operation 


H 
| 
i) 
t 
H 
| 
| 
| 
| X'AOnn' 
i 
H 
| 
[} 
H 
1 
H 


! 
! 

Xx'COnn' ! Illegal function code 
| Common bus unavailable 

X'84nn' Hardware failure, bad status returned from connect 
or CLEAR 

"82nn' | Time-out or connect requested with bus connected, 

’ 


or clear requested with bus not connected 


eo eS oS SD eS A SD GG ey CO ATS NE SD ED OUD OND UND ED OED OUND Gey OS Gee Gem tes tly) GE SS nee ey Se me es ee OS eS ee EG ee eee Gee ES Ds iS ce ee me De el oe ee ee me ome 
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NOTE 


‘nn' always indicates the switch hardware 
status. The following list presents some 
possible hardware status values. See the 
Input/Output Switch (10S) Installation 
and Maintainence Manual for more 
information. 


e 00 - indicates that the switch is 
selected by a normal or master 
request. 


e Ol - indicates that the switch is 
unavailable due to power loss on 
the common bus or disconnected 
cables. 


e 02 - indicates that the bus is busy 
auring a CLEAR interval 
(100-200ms). 


e 08 - indicates that the switch is 
idle. 


e OA - indicates that the bus is busy 
servicing another processor. 


2.4.4 Programming Considerations 


After acquiring the common bus via a MASTER CONNECT, the 
acquiring processor should immediately issue a CLEAR. This is 
necessary because a MASTER CONNECT clears any active normal 
connects, thereby leaving the state of interfaces unknown. The 
CLEAR command causes the common bus to be initialized (same _ as 
depressing the processor INIT button), which places interfaces in 
a known state. 


In a multiple master configuration, a processor acquiring the bus 
via MASTER CONNECT should immediately relinquish the bus) and 
reacquire it via a NORMAL CONNECT. This will allow any other 
master processors to acquire the bus via MASTER CONNECT. 


After issuing a NORMAL CONNECT or a MASTER CONNECT, the calling 


procedure should ENABLE interrupts. It is the user's 
responsibility to know what devices were hung on the common. bus 
at sysgen. If a common bus is not connected with interrupts 


enabled, a driver call to any device on the common bus results in 
a device unavailable status return on a time-out from the 
requested device's driver. 
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The parameter block fields used for switching operations are the 
function code, status halfword and, optionally, the random 
address field (used to specify wait time). 

The following examples illustrate the ways in which the I/O bus 
switch may be used. 

Examples: 

This example shows the inclusion of the switch in the Sysgen/32 


DEVICES statement. 


DEVICES 


10S1:,32,143 


ENDD 


The I/O bus switch may then be assigned in the normal manner 
(i.e, via SVC7 or an operating system multi-terminal monitor 
(OS/MTM) command). 


LOAD DMO, SWCHDEMO xany task that uses switch 
TASK DMO *not necessary from MTM 
AS 7,I10S1: *switch 

START 


The switch may then be controlled via standard SVCl_ function 
codes, as illustrated by the following simplistic CAL routines. 


BEGIN EQU x 


SWCHLU EQU 7 SWITCH ASSIGNED TO LU 7 
DELAY EQU 5 WAIT 5 SEC BEFORE TIME OUT 
NRML EQU X'38' NORMAL CONNECT W/WAIT FC 
ENAB EQU Xx'CO' ENABLE FC 


DISCON EQU X'88' DISCONNECT FC 
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SWCHPREP EQU 


GETBUS  EQU 


RLSEBUS EQU 


15,SWCHPREP 
15,RLSEBUS 


3, EOTCODE 


* 


12,SAVEREGS 
12, SWCHLU 
13 , DELAY 
14,NRML 
15,ENAB 

* 


12,SVC1.FC 
13,SVC1.RAD 
14,SVC1L.FC 
1,SVC1.FC 
14,SVC1.STA 
14,X'00' 
CONNERR 
15,ENAB 
1,SVC1.FC 
15,SVC1.STA 
15,X'OO' 
ENABERR 
12,SAVEREGS 
15 


x 


12, SAVEREGS 
14,DISCON 
12,SWCHLU 
14,SVC1.FC 
12,SVC1.LU 
1,SVC1.FC 
14,SVC1.STA 
14,X'OOFF' 
DSCNERR 
12,SAVEREGS 
15 


x 


GO GET BUS 


RELEASE BUS 


SAVE REGISTERS 
PICK UP LU # 
PICK UP DELAY 
PICK UP FC 
PICK UP FC 


LU # TO PARBLK 

DELAY TO PARBLK 

CONNECT W/WAIT TO PARBLK 
ISSUE CONNECT REQUEST 

PICK UP STATUS 

CHECK FOR SUCCESSFUL CONNECT 
GO TO ERR ROUTINE 

ENABLE FC TO PARBLK 

ISSUE ENABLE INTERRUPTS REQUEST 
PICK UP STATUS 

CHECK FOR SUCCESSFUL ENABLE 
GO TO ERR ROUTINE 

RESTORE REGISTERS 

BUS READY - GO DO I/O 


SAVE REGISTERS 

PICK UP DISCONNECT FC 
PICK UP LU # 

DISCONNECT TO PARBLK 

LU # TO PARBLK 

REQUEST DISCONNECT 

PICK UP STATUS 

CHECK STAT - HARDWARE N/A 
GO TO ERR ROUTINE 

RESTORE REGISTERS 
DISCONNECTED - DO WHATEVER 
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ENABERR EQU 


DSCNERR EQU 


* 


* DEFINITIONS 
x 


SAVEREGS DSF 
EOTCODE DS 


END 
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BEGIN 


REGISTER SAVE AREA 
HALFWORD FOR EOT 
PICK UP SVCl STRUC 


CHAPTER 3 
GENERAL SERVICE FUNCTIONS SUPERVISOR CALL 2 (SVC2) 


3.1 INTRODUCTION 


SVC2 provides general service functions distinguished from one 
another by a specific function code number. Each SVC2 function 
requires a specific parameter block for proper operation. Refer 
to each individual code for its parameter block format and 
required coding. Table 3-1 lists all available SVC2 function 
codes with a brief description of each. 


TABLE 3-1 SVC2 FUNCTION CODES 


ne em em oes eee ime ee mee owe ey caw me mem ee ome ey ee mee oe ines nee em ates pene ame meme ee me ee mn em em eee ee ee ee ee mee ee ee ee ee ee ee ee oe ee 


executive task (e-task). 


een Be Eee ee ee ee ee ee Oe ee ee 


H SVC2 CODE H NAME H FUNCTION 1 
' SS SSSSss RBZ TE SESS Bs SHS SEBS VIHSI SESE BEVISALlSEBVAaSSSSSPBTRTVTSsBTBSEFSFSsSTBTSTsrVssS2222 H 
| SVC2 code 0 | Make journal | Makes an entry into the H 
H } entries | system journal from an H 
i i 
t 


| Places the task ina ' 
| suspended state. 


' 
| Reserves a workspace area 
| for external subroutines | 
| called by the task during 
|} execution. H 

{ 
Release storage Releases the temporary 
storage locations obtained 
by a previous SVC2 code 2. 


Gets storage by decreasing 
the task UTOP by the number 
of user-specified bytes. 

Set status | Modifies the arithmetic H 
| fault interrupt bit and 
;} condition code (CC) in the i 
| program status word (PSW). H 
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TABLE 3-1 SVC 2 FUNCTION CODES (Continued) 


SVC2 CODE 


SVC2 code 5 


NAME 


Fetch pointer 


Convert binary 
to ASCII 
hexadecimal or 
ASCII decimal 


clock 


wait 


Convert ASCII 

hexadecimal or 
ASCII decimal 

to binary 


FUNCTION 


| 
Copies the address of UTOP, | 
CTOP and UBOT from the task | 
control block (TCB) and 
stores them in the task | 
user-dedicated location H 
(UDL) . 

! 


Converts a binary number to | 
either an ASCII hexadecimal | 
or ASCII decimal number. ! 
' 
' 
J 


Sends a message to the H 
appropriate log device 
regardless of the current 
logical unit (lu) assign- t 
ments. | 

t 


Sends the user the current H 
time of day calculated in H 
seconds from midnight in H 
binary or in formatted H 
ASCII. 


I 
Sends the user the current i 
date in formatted ASCII. H 

i 


Places the calling task in | 
a wait state until a H 
specific time of day. 

! 


— a me ae aS me ee tS em es wee ce em eee ey ee eee es ee ee ee ce ee me ee ee ee ce ee ee ee ee ee ee ee ee ee 


Places the calling task ina } 
Wait state for an interval, H 
which is specified in H 
milliseconds from the time { 
the call is executed. | 


1 
| 
Allows a foreground task { 
loaded from the system 
console to invoke operator H 
and command substitution 
system (CSS) commands. H 

! 

I 


Converts an ASCII hexa- 


t 
! 
decimal or ASCII decimal | 
number to a binary number. { 
] 
| 
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TABLE 3-1 SVC2 FUNCTION CODES (Continued) 


| SVC2 CODE NAME 1 FUNCTION 
| SESes PTS SSeFftetas esse SBTeFZEPSS TESS SABES SS SESS SSS TrSTsSsVZtPEseBEeste SSewstsesezc2Lle2= 
SvC2 code 16 | Pack file } Processes a user-specified 
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descriptor 


Scan mnemonic 
table 


Move ASCII 


characters 


tion 


Contract alloca- 
tion 


Timer 
management 


unpacked file descriptor 
(fa) into a packed format to 
be used by the operating 
system. 


Fe eR Re ee A Re ee ee Ee 


Scans for an ASCII character 
string in a mnemonic’ table 
and compares it with the 
user-specified ASCII charac- 
ter string for a match. 


a Ne Ne ee ee ere a eae ne rele Dh a Ree ee ee ee ee 


Moves a specified number of 
ASCII characters in memory 
from the sending location to 
a receiving location. 


Obtains user-related infor- 
mation from operating system 
data structures. 


a Me ee Nr i er et ee ee ea ee a ee re ee eed 


Reserved for sequential 
tasking machines. Provides 
for compatibility with 
current 32-bit operating 
systems. 


Reserved for sequential 
tasking machines. Provides 
for compatibility with 
current 32-bit operating 
systems. 


Schedules the addition of a 
parameter to a task queue on 
completion of a specified 
interval or a repetitive 
interval. 


Puts a task in await state 
until completion of an 
interval. 


Determines the time remain- 
ing for a previously estab- 
lished interval to expire. 


Cancels a previously estab- 
lished interval. 


ae ees ee we ee we es ee eee eee we eee ee ee ee ee ee ee me me ee we ww ew we we 


ee ee ee ee ee ee ee ee ee ee we ee ee we ee we oe 


TABLE 3-1 SVC2 FUNCTION CODES (Continued) 


en NE em NS a EE Sg Se ee ee ee ee ee ee tet oe ee ee ee ee ee eee adi ee ie eee etd wei nih So een mie mo 


SVC2 CODE 


SVC2 code 24 


NAME 


Set accounting 
information 


Fetch 
accounting 
information 


Fetch device 
name 


Memory manage- 
ment 


Unpack file 
descriptor 


FUNCTION 


| 
Stores eight bytes of user- | 
supplied information in the | 
accounting transaction file | 
(ATF) on task completion or | 
data overflow of accounting | 
records. t 

t 

' 


A em ED COND ey Se ES cee sy ES DS US ER GD GE on SE a GD ED Oe A GRO OE ee me me SO eet) ee) Qu GD EE mE ee te omy me mle ate won 


Fetches accounting informa- | 
tion and stores it ina 
user-specified receiving H 
area. | 
! 
| 


Searches the volume mnemonic | 
table (VMT) for a user- | 
supplied volume name and 
returns the name of the { 
device on which that volume (| 
is mounted. | 

t 


Allows a user task (u-task) { 
to access and modify entries | 
(except shared ones) within | 
the private segment table | 
(PST) in its TCB. 


Converts a packed fd from 
the file directory or an | 
SVC7 paramter block to its | 
unpacked format. 


CE ee lee anne ane ee ee ee ee NT ee ee ee ee eS ee 
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KN 
< 
Q 
th 


3.2 SVC2 CODE 0: MAKE JOURNAL ENTRIES 


SVC2 code 0 makes an entry into the system journal from an 
e-task. The system journal provides a method to trace back 
important events (SVCs, input/output (1/0) operations, task 
switching) that occurred during system operation. For example, 
the journal is useful for tracing the cause of a system failure. 
The parameter block format for SVC2 code 0 is shown in Figure 
3=L. 


— = ee oe ee oe ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee eee ee ee ce ee ee ee eee ee ee ee ee ee ee ee ee ea ee 


10(0) 12(2) 
' Code { Journal code H 
| | | 
[eg a eae seen ee eae ea pa ae a eeeeeeee eae ee 
14(4) ! 
H Value 1 H 
se ss a, shes ium ave me s,m ce: eh, se sm cd mmm, ‘nem, eh seek etn es se es sh | 
18(8) 
Value 2 
Mess ee ‘sao ea“ i ‘tm ui a ‘mc’ ms ew “eam ec Cum mis cst. ee nme “hese n'a an mam“ mes ssi lash etm i 
}12(C) ! 
bs Value 3 
| ! 
laser Cano wi acer neni a ein nn a ie a a | 
116(10) 
Value 4 

SVC 2,parblk 

parblk DC H'O' 

DC H'journal code' 

DC F'value 1' 

DC F'value 2' 

DC F'value 3' 

DC F'value 4' 


Figure 3-1 SVC2 Code 0 Parameter Block Format and Coding 
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During execution, a logical-OR operation is performed on a mask 
and the journal code to indicate that the entry originates from 
an SVC2 code 0, rather than from within the system. The value 1, 
2, 3 and 4 fields of the parameter block are stored following the 
journal code and calling task name in the journal. These values 
can contain any desired information to be preserved for system 
debugging. 


NOTE 
This call has an effect only if the 


journal is included in the system at 
(source) system generation (sysgen) . 
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Q 
oO 7 
U< 
HO 
NO 
re 


3.3 SVC2 CODE 1: PAUSE 


SVC2 code 1 stops task execution and places the task into 
suspended state. This is accomplished through the SVC2 code 
parameter block shown in Figure 3-2. 


re 


O 
'S 
cr 
- 
0 
Dp] 
™ 
te) 
Q, 
@ 


mee oe ee ee ee ee ee ee ee ee ee ee ee eee ee ee ee eee ne ee ee ee ee ee a ee ee ee 


Svc 2,parblk 


ALIGN 4 
parblk DB 0,1 


Figure 3-2 SVC2 Code 1 Parameter Block Format and Coding 


This parameter block must be two bytes long, fullword 
boundary-aligned, and does not have to be located within a 
task-writable segment. Following is a description of each field 
in the parameter block. 


Fields: 
Option is a l-byte field that must contain a value of 
0 to indicate no options for this call. 
Code is a 1l-byte field that must contain the 


Gecimal value 1 to indicate code 1 of SVC2. 


After executing SVC2 code 1, the following message is displayed 
on the system console: 


TASK PAUSED 
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If the task is running under MTM, the above message is displayed 
on the user console. 


While the task is paused, the operator can issue commands 
directed to the paused task to change the task environment. To 
continue task execution, enter the CONTINUE command. Task 
execution resumes with the instruction immediately following SVC2 
code l. 
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3.4 SVC2 CODE 2: GET STORAGE 


SVC2 code 2 reserves a workspace area for external subroutines 
called by the task during execution (e.g., FORTRAN run-time 
library (RTL) routines). This workspace is reserved in the 
unused portion of the task's impure segment between UTOP and 
CTOP. For more information on this segment, see the 0S/32 
Application Level Programmer Reference Manual. 


The SVC2 code 2 operation does not increase the task's allocated 
memory size. 


Figure 3-3 illustrates the parameter block for SVC2 code 2. 


Ce er Ea ee i EN ee 


10(0) i1(1) 12(2) 13(3) 
1 Option H Code H Reserved | User H 
! t | register 
[See SERS ee ee a ee eee ee eee See | 
| 4(4) 
Number of bytes 
! i 
J ' 

svc 2,parblk 

ALIGN 4 

parblk DB option,2,0 
DB user register 
be F'number of bytes' 


Figure 3-3 SVC2 Code 2 Parameter Block Format and Coding 


This parameter block must be eight bytes long, fullword 
boundary-aligned, and located in a task-writable segment when 
option X'80' is used. A general description of each field in the 
parameter block follows. 
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Fields: 


Option is a l-byte field that must contain one of the 
following options: 


e Option X'00' reserves the user-specified 
number of bytes in fullword increments in 
the unused portion of the task impure 
segment between UTOP and CTOP. 


@ Option X'80' reserves the remaining unused 
portion of the task impure segment between 
UTOP and CTOP. 


Code is a l1-byte field that must contain the 
decimal value 2 to indicate code 2 of SVC2. 

Reserved is a reserved l-byte field that must contain 
a 0. 

User is a l-byte field that must contain a decimal 

register number ranging from 0 to 15 specifying the 


register to receive the starting address of 
the reserved workspace area. 


Number is a 4-byte field containing different 
of bytes information for each option. 


e Option X'00' contains the user-specified 
number of bytes to be reserved for the 
workspace area. 


@ Option X'80' receives the number of bytes 
actually reserved for the workspace area. 


When a task is link-edited, the default task workspace (the 
difference between CTOP and UTOP) should be large enough to 
provide enough workspace for both the task and the external 
subroutines. The task workspace can be increased through the 
WORK= parameter of the Link OPTION command, the LOAD command or 
an SVC6. 
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After executing SVC2 code 2, the CC is set as follows. 


Condition Code: 


ee eee came Seem Gee conn Ge Ge ie te, es ee eee ome 


Normal termination 

User-specified number of bytes is a nega- 
[SSS SSS SSS tive value or a value greater than the 
task's allocated memory size 


NOTE 


When SVC2 code 2 is executed and the task 
UTOP changes, the UTOP address stored in 
the task UDL is not updated to contain 
the most current UTOP. SVC2 code 5 
updates the address in the UDL. 


3.4.1 SVC2 Code 2, Option x'00' 


If option X'00' is specified, the address of the task's current 
UTOP is adjusted to include the number of user-specified bytes in 
the parameter block. Once the UTOP address is adjusted, the 
starting address of the reserved workspace area, which is’ the 
original or previous UTOP, is stored in the user-specified 
register. This option can reserve new workspace areas until they 
are needed during task execution in subsequent calls. 


The number of bytes should be specified in fullword increments 
because the UTOP address is rounded up to the nearest fullword 
boundary. 


Example: 
svc 2,GET 
ALIGN 4 
GET DB 0,2,0 
DB 5 
DC y¥'600' 1.5K 
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This example is illustrated in Figure 3-4. A task is loaded with 
a task workspace area of 5.5kb specified in the LOAD command. 
After the task is loaded, UTOP is located at X'C78' and CTOP is 
located at X'1FFE'. After executing SVC2 code 2, UTOP is 
adjusted to X'1278'. The remaining unused portion (area between 
X'1278' and X'2000') can be used by subsequent routines’ when 
needed during task execution. 


If the user-specified number of bytes for option xX'O0O' is a 
negative value or greater than the task current allocated memory 
size (CTOP): 


@ The UTOP address is not adjusted 


@ An address of 0 is returned in the user-specified register 


@ The CC is set to 4 (V bit set) 


038-1 


EXPANDED THROUGH 
WORKSPACE FIELD OF 


X‘2000’ - LOAD COMMAND 


(ABOVE USER 
TASK) X’1F FE’ CTOP 
(AFTER LOAD TIME) 
UTOP X‘1278' 
(AFTER SVC 2 5.5kb 


CODE 2 EXECUTION) 


X‘600' BYTES 
(RESERVED BY 
SVC 2 CODE 2) 
hcg 
Fae: X‘A54’ CTOP 
USER CODE 
X‘100’ | 
UBOT X’0’ 


Figure 3-4 Task Impure Segment for SVC2 Code 2, Option X'00' 
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3.4.2 SVC2 Code 2, Option x'80! 


If option X'80' is specified, the parameter block must be located 


in a writable segment. The address of the task's current UTOP is 
adjusted to include all of the remaining unused portion in the 
impure segment, making UTOP equal CTOP+2. Once the UTOP address 
is adjusted, the starting address of the reserved workspace area, 
which is the address of the original or previous UTOP, is stored 
in the user-specified register. Also, the number of bytes 
actually reserved is stored in the number of bytes field in the 
parameter block. 


Example: 
Svc 2,GET 
ALIGN 4 
GET DB X'80',2,0 
DB 5 
DS 4 


This example is illustrated in Figure 3-5. A task is linked with 
a workspace greater than 5.5kb. After the task is loaded with a 
load expand factor of 5.5kb, UTOP is located at X'C78'. After 
executing SVC2 code 2, UTOP is adjusted to X'2000'. 


038-2 


UTOP X‘1C00" 
(AFTER SVC 27— 


CODE 2 EXECUTION) il 
X‘AFE’ CTOP 
X'100' BYTES (AFTER EXPANSION 


BY LOAD) 
UTOP X'F00' Pes | 


(AFTER SVC 2 
CODE 3 EXECUTION) 


3.75kb 


X'CFE’ CTOP 


pes od (BEFORE EXPANSION 


BY LOAD) 


UTOP X'C78' eae 


(AT LOAD TIME) 


USER CODE 


X‘'100° 


UBOT X‘0" 


Figure 3-5 Task Impure Segment for SVC2 Code 2, Option X'80' 
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3.5 SVC2 CODE 3: RELEASE STORAGE 


SVC2 code 3 releases the workspace area in the unused portion of 
of the task impure segment that had been reserved by a previous 
SVC2 code 2 (see Section 3.3). Releasing the reserved workspace 
for external subroutines does not decrease the task's allocated 
memory size. The SVC2 code 3 parameter block is shown in Figure 
376. 


10(0) i1(1) 12(2) 
Option Code | Reserved | 
| { { t 
ac Teen eet ny Sa eee Beer ROE Eee ! 
14(4) | 
Number of bytes | 
' t 
' ' 

SVC 2,parblk 

ALIGN 4 

parblk DB 0,3 
DC H'O' 


DC F'number of bytes' 


Figure 3-6 SVC2 Code 3 Parameter Block Format and Coding 


This parameter block is eight bytes long, fullword 
boundary-aligned, and does not have to be _ located in a 
task-writable segment. A description of each field in the 
parameter block follows. 


Fields: 
Option is a l-byte field that contains a value of 0 
to indicate no options for this call. 
Code is a l-byte field that must contain the 


decimal value 3 to indicate code 3 of SVC2. 
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Reserved is a reserved 2-byte field that must contain 


zeros. 
Number is a 4-byte field that must contain the 
of bytes user-specified number of bytes of the reserved 


workspace to be released. 


When executing this SVC, the address of the task's current UTOP 
is adjusted to exclude the user-specified number of bytes of 
reserved workspace. If the number of bytes is not specified in 
fullword increments, the UTOP address is adjusted by rounding 
down to the nearest fullword boundary. After executing SVC2 code 
3, the CC is set as follows. 


Condition Code: 


ee ee cS SE ee Sl ey ee Se oe ee oe 


;Cfl}vi GQiutkL | 
| SS Se Se ES BE ee SS ES ss SE RR EE | 
;}of;o };o } O | Normal termination 
; OO; 1 4:0 ; O | User-specified number of bytes is a nega- 
SSS Se ‘tive value or a value greater than the 
task's allocated memory size 
Example: 
Svc 2, RELEASE 
ALIGN 4 
RELEASE DB 0,3 
DC H'O' 


DC F'256' 


Figure 3-7 illustrates this example. A task was linked with a 
workspace of 3.75kb and loaded into memory. After the task is 
loaded, UTOP is located at X'C78' and CTOP is located at X'FFE'. 
After executing SVC2 code 2, UTOP is adjusted to X'1000'. After 
executing SVC2 code 3, 256 bytes of reserved storage are 
released, adjusting UTOP to X'FOO'. 
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038-3 bxPANDED THROUGH 
THE LINK OPTION 


COMMAND 
UTOP X'2000' 
(AFTER SVC 2 X'1FFE’ CTOP 
CODE 2 EXECUTION (AFTER EXPANSION 
BY LOAD) 
X'F00' BYTES 5.5kb 
- | X‘CFE’CTOP 
(AT LOAD TIME) Fe ee tl fff f BY LOAD) 


USER CODE 


X‘100' 


UBOT X’‘0’ 


Figure 3-7 Task Impure Segment for SVC2 Code 3 


If the user-specified number of bytes is a negative number or is 
more than the number specified by Link, the UTOP address is not 
adjusted and the CC is set to 4 (V bit set). 
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3.6 SVC2 CODE 4: SET STATUS 


SVC2 code 4 modifies the arithmetic fault interrupt bit and the 
CC settings in the PSW. Figure 3-9 shows the PSW and the bits 
affected by the set status operation. When the arithmetic fault 
interrupt bit setting is modified, interrupts are enabled or 
Gisabled. When the CC setting is modified, the current 4-bit 
setting is replaced with a new 4-bit' setting. This is 
accomplished through the SVC2 code 4 parameter block shown in 
Figure 3-8. 


Cl A I ee ee ee eel 


10(0) i1(1) {2(2)Arithmetic}3(3) Condition} 
1 Option i Code fault code 
{| parameter | parameter | 
Svc 2,parblk 
ALIGN 4 
parblk DB option,4 
DB arithmetic fault parameter, condition 


code parameter 


Figure 3-8 SVC2 Code 4 Parameter Block Format and Coding 


This parameter block is four bytes long, fullword 
boundary-aligned, and does not. have to be _ located in a 
task-writable segment. A general description of each field in 
the parameter block follows. 


Fields: 


Option is a l-byte field that must contain one of the 
following options: 


@ Option X'00' modifies the arithmetic fault 
bit and CC in the PSW. 


@ Option X'80' modifies only the CC in the 
PSW (see Figure 3-9). 
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Code is a l-byte field that must contain the 
decimal value 4 to indicate code 4 of SVC2. 


Arithmetic is a l-byte field that must contain one of 
fault the following parameters when option X'00' is 
parameter specified. For option X'80', this field must 


contain zeros. 


e x'oo' disables all arithmetic fault 
interrupts for Models 7/32 and 8/32 
Processors. For Perkin-Elmer Series 3200 
Processors, only arithmetic fault 
interrupts due to floating point underflow 
are disabled. 


e x'10' enables all arithmetic fault 


interrupts. 
Condition is a l-byte field that must contain a 
code hexadecimal value ranging from X'00' to X'OF'. 
parameter 
Arithmetic fault Condition 
Reserved interrupt bit Reserved code 


ce ee ce cee ee ee eee ee ee ee ee ee ee ae es ee 


wil IM {A {I {RPIQ | 


15 16 17 18 19 20 21 22 23 24 27 28 29 30 31 


Reserved 


Bits: 
32 39 40 63 


Figure 3-9 Program Status Word (PSW) 
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An arithmetic fault occurs during an arithmetic operation for any 
of the following conditions: 

e Fixed point quotient overflow 

e Fixed point division by 0 

e Floating point overflow and underflow 

@e Floating point division by 0 

The CC (bits 28 through 31) is set after executing certain 
instructions. Each bit in the CC corresponds to a result or 


condition caused by executing an instruction. The CC settings 
for arithmetic operations follow. 


Condition Code: 


;ecey}viGcgiytkL } 

| == eos sees | 

tf 1 i}0; 0; 0 | Arithmetic carry, borrow or shifted carry 
; oi} 1it0a}yo i} Arithmetic overflow 

;Oj};o}1L | O | Greater than O 

;o}ot} 0% 1 4: #=%Less than 0 


ore ee eee ee ee ee ee ee ee ee ee 


These four bits have different meanings for logical operations, 
branching operations and I/O operations. For the definitions of 
the bit settings for each particular operation, see the 
appropriate processor manual. 


3.6.1 SVC2 Code 4, Option xX'O0' 


If the SVC2 code 4 parameter block contains X'00' in the option 
field, xX'OO' in the arithmetic fault field, and a value ranging 
from X'00' to X'OF' in the CC field, all arithmetic faults are 
ignored for Models 7/32 and 8/32 Processors. For Series 3200 
Processors, only arithmetic faults resulting from floating point 


underflow are ignored. For more information on Series 3200 
arithmetic fault interrupts, see the appropriate Series 3200 
Processor Manual. The current CC value in the PSW is replaced 


with the value specified in the CC field of the parameter block. 
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If the SVC2 code 4 parameter block contains X'00' in the option 
field, xX'10' in the arithmetic fault field, and a value ranging 
from X'00' to xX'OF' in the cC field, all arithmetic fault 
interrupts are enabled. The current CC value in the FSW is 
replaced with the value specified in the CC field of the 
parameter block. 


3.6.2 SVC2 Code 4, Option X'8s0' 


If option X'80' is specified and the CC parameter field contains 
a value of X'0O0' through X'OF', the current CC value of the PSW 
is replaced with the value specified in the CC field of the 
parameter block. The arithmetic fault field is ignored. 
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3.7 SVC2 CODE 5: FETCH POINTER 


SVC2 code 5 loads the starting address of a task's UDL into a 
user-specified register. It then stores the current addresses of 
UBOT, UTOP and CTOP, located in the TCB, into their corresponding 
locations in the task UDL. This is accomplished through the SVC2 
code 5 parameter block shown in Figure 3-10. 


2(2) 13(3) 
Reserved 1 User 
register 


a Mr en i re Re ee ee ee cee ee eee ie are ee a ee ee ee ee 


H Option i Code { 
1 { 
{ { 


SVC 2,parblk 


ALIGN 4 


parblk DB 0,5,0 
DB user register 


Figure 3-10 SVC2 Code 5 Parameter Block Format and Coding 


This parameter block is four bytes long, fullword 
boundary-aligned, and does not have to be _ located in a 
task-writable segment. A description of each field in the 
parameter block follows. 


Fields: 
Option is a l-byte field that must contain the value 
0 to indicate no options for this call. 
Code is a l-byte field that must contain the 
| decimal number 5 to indicate code 5 of SVC2. 
Reserved is a reserved l-byte field that must’ contain 


a 0. 
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User is a l-byte field that must contain a 


register decimal number from 0 to 15, indicating the 
register that receives the UDL starting 
address. 


When executing this call, the UDL starting address, which is 
loaded into the user-specified register, varies for u-tasks and 
e-tasks. The starting address for a u-task is the relative 
address, which is always 0. The starting address for an e-task 
is the absolute address, which depends on the task memory 
location. 


If the user modified the UDL by changing address pointers or if 
UTOP was changed by a GET or RELEASE STORAGE, the contents of 
CTOP, UTOP and UBOT in the UDL might not be valid. SVC2 code 5 
restores this data to a valid state by storing the current values 
of CTOP, UTOP and UBOT into the UDL. 


Example: 


UDL after execution of SVC2 code 2 and before execution of SVC2 
code 5: 


cent eeeaeeeeTien M e e 


}_ ts CTOP 
H | X'FFE'! 
eee { 
UTOP |} H 
X'928' |-------------------------------- - - - - - - - - - - - H 
] | 
4 t 
ins User code lac 
ri i" 
X'100! |---------------- --------------------------------- : 
| 
UDL 
H 1 
| ts ese eens eS tm as ac ines eo ates Reem ge cee ene sh ats be eae ah ree Seed ee segs Sse ee H 
IX'FFE'{X'128'!} x'o' $ H H 1 { 
UBOT X'Q' ----------~-~------------------------------------ 


CTOP UTOP UBOT DMS TSKQ SDQ MSGR SV14 


Invalid 
Address 
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UDL after execution of SVC2 code 5: 


ee ee ee cee ee ee Me ee ers OO Snr! Gee mem ee ee ee eek met me ee ee ee ee me ee ee ee ee 


1... |} CTOP 
\ | X'FFE' 
{ I 
Dee recesses rete nn en { 
UTOP | 
X'928!' | -------~-------------- -- - ee 
( 1 
i) { 
— User code me 
X'100! | --r- er nr rn eee 
UDL. . 
| 
| ere ak cei etn ses Gs cca “eis “obese thew teem se i cc cs fe sg se eo aes a amis ee es raat emt ei da et as y 
{X'FFE'{X'928'}; X'O' | H 1 H } 
UBOT :X!0" “eee asessheses-sS55- EO Mniicr a mingaL Kaas a Da ee 


CTOP UTOP UBOT DMS TSKQ SDQ MSGR SV14 


Valid 
Address 


For more information on the UDL, see the OS/32 Application Level 
Programmer Reference Manual. 
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3.8 SVC2 CODE 6: CONVERT BINARY NUMBER TO ASCII HEXADECIMAL OR 
ASCII DECIMAL 


SVC2 code 6 converts an unsigned 32-bit binary number located in 
user register 0 to an ASCII hexadecimal number or an ASCII 
decimal number. This is accomplished through the SVC2 code 6 
parameter block shown in Figure 3-1l. 


oe ee ee SE Gems ce em me een ee ee ee es ee et ee ee ee ee me ee See ee ee ee SE ee ee EY eee Ge ee ee ee een ee ee en ome ote 


10(0) }1(1) 12(2) | 
Optiontn Code i Reserved 
( i t ! 
ee ee ee | 
14(4) 
H Address of receiving buffer ! 

svc 2,parblk 

ALIGN 4 

parblk DB option+n,6 
DC H'OQ' 


DCF A(receiving buffer) 
Figure 3-11 SVC2 Code 6 Parameter Block Format and Coding 
This parameter block is eight bytes long, fullword 
boundary-aligned, and must be located in a task-writable segment. 


A general description of each field in the parameter block 
follows. 
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Fields: 


' Optiontn is a l-byte field that must contain the sum of 
one of the following options’ and n (n 
specifies a decimal number from 0 to 63 
indicating the number of bytes in the _ buffer 
specified in the SVC2 code 6 parameter block). 


@ Option X'00'+n converts a binary number to 
ASCII hexadecimal. 


@ Option X'40'+n converts a binary number to 
ASCII hexadecimal, suppressing leading 
zeros. 


@ Option X'80'+n converts a binary number to 
ASCII decimal. 


@ Option X'CO'+tn converts a binary number to 
ASCII decimal, supressing leading zeros. 


Code is a l-byte field that must contain the 
decimal number 6 to indicate SVC2 code 6. 

Reserved is a reserved 2-byte field that must’ contain 
zeros. 

Address of is a 4-byte field that must contain the 

receiving address of the previously allocated buffer 

buffer that receives the converted number. This 


address can be located on any byte boundary. 


The receiving buffer should be defined to receive the largest 
number, which is is 2,147,483,647 (2°! -1), that can be converted 
from register 0. Allocate an 8-byte buffer for binary to ASCII 
hexadecimal. Allocate a 10-byte buffer for binary to ASCII 
decimal. If the user's largest number to be converted is less 
than 2°51 -1, the receiving buffer can be less than the suggested 
length of the buffer. 


When the user-specified binary number located in register 0 is 
converted, the result is stored right-justified in the receiving 
buffer with the left-most significant digits filled with ASCII 
zeros. However, if the converted number is longer than the 
buffer, the left-most digits of the converted number are lost. 
If suppression of leading zeros is requested, the left-most zeros 
in the receiving buffer are filled with spaces (hexadecimal 20). 
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3.8.1 SVC2 Code 6, Option X'00'tn 


If option X'00'+n is specified, the unsigned 32-bit binary number 
located in the user register 0 is converted to an ASCII 
hexadecimal number . The resulting number is stored 
right-justified in the receiving buffer with the left-most 
significant digits filled with ASCII zeros (hexadecimal 30). 


Example: 

LI 0,F'8520! 
Svc 2, CONVERT 
ALIGN 4 

CONVERT DB X'00'+8,6 
DC H'O! 
DCF  A(BUF) 

BUF DS 8 


Register 0 before and after execution of SVC2 code 6: 


oa ee ee 


Receiving buffer after execution of SVC2 code 6: 


Zero filled 


ee ee ee ee ee 


3.8.2 SVC2 Code 6, Option X'40'+tn 


If option X'40'+n is specified, the unsigned 32-bit binary number 
located in the user register 0 is converted to an ASCII 
hexadecimal number. The resulting number is stored 
right-justified in the receiving buffer with the left-most 
significant digits filled with ASCII spaces (hexadecimal 20). 
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3.8.3 SVC2 Code 6, Option X'80'+n 


If option X'80't+n is specified, the unsigned 32-bit binary number 
located in the user register 0 is converted to an ASCII decimal 
number . The resulting number is stored right-justified in the 
buffer with the left-most significant digits filled with ASCII 
zeros (hexadecimal 30). 


Example: 

PROG CONVERT 
LI 0,F'16322' 
svc 2,CONVERT 
ALIGN 4 | 

CONVERT DB X'80'+10,6 
DC H'OQ' 
DCF A( BUF ) 

BUF DS 10 


Register O before and after execution of SVC2 code 6: 


10 Of} O O;3 mS 2{ Hex 


Receiving buffer after execution of SVC2 code 6: 


Zero-filled 


13 O} 3 O}3 ole 0/3 0/3 1/3 61/3 3/3 2;3 2} Hex 


3.8.4 SVC2 Code 6, Option X'CO'+tn 


If option X'CO'+n is specified, the unsigned 32-bit binary number 
located in the user register 0 is converted to an ASCII decimal 
number. The resulting number is stored right-justified in the 
receiving buffer with the left-most significant digits containing 
zeros filled with ASCII spaces (hexadecimal 20). 
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3.9 SVC2 CODE 7: LOG MESSAGE 

SVC2 code 7 sends a user-specified message to the system console, 
user terminal or user-specified log device, depending on the task 
environment. This is accomplished through the SVC2 code 7 
parameter block in Figure 3-12. Log devices for specific task 
environments are: 

e System console for background tasks 

@e System console for foreground tasks 

@ User MTM terminal for MIM terminal tasks 

@ User-specified log device for MTM batch task 


If no user-specified log device is allocated for MTM batch tasks, 
the message is lost. 


10(0) i1(1) 12(2) | 
H Option | Code | Length of message | 
! { t 

Eee eee ee Oe a ee eee 7 
14(4) | 
H Contents of message* or address of message buffer 
j ' 
] ' 


— ee A Powe ES NO ee SG eee mS ee ee ee ee ee ee ee ee ee ee ee ees ee ee oe cee ee ee ee ee ee 


svc 2,parblk 


ALIGN 4 
parblk DB option,7 
DC H'length of message' 
DC C'contents of message' or 
A(message buffer) 


* When the contents of message field is used, the size of 
the parameter block can vary. 


Figure 3-12 SVC2 Code 7 Parameter Block Format and Coding 
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This parameter block is eight bytes long if the address of 


message buffer field is used. [It is variable in length if the 
contents of message field is used. It must be fullword 
boundary-aligned and does not have to _ be located in a 
task-writable segment. A general description of each field in 


the parameter block follows. 


Fields: 
Option is a l-byte field that must contain one of the 
following options: 

@ Option X'00' indicates message contents, 
formatted. 

@e Option X'20' indicates message contents are 
formatted and sent to the system console 
only. 

@ Option X'40' indicates message at specified 
buffer address, formatted. 

@ Option X'60' indicates message at specified 
buffer address is formatted and sent to the 
system console only. 

@e Option X'80' indicates message contents, 
image mode. 

@ Option X'AO' indicates message contents are 
sent in image mode to system console only. 

e Option X'CO' indicates message at specified 
buffer address, image mode. 

@ Option X'EO' indicates message at specified 
buffer address is sent in image mode to the 
system console only. 

Code is a l-byte field that must contain the 

decimal number 7 to indicate SVC2 code 7. 

Length of is a 2-byte field that must contain a decimal 
message number indicating the number of bytes’ the 
message occupies. The message can be 
truncated by the log device driver. If the 


message is being logged to the system console, 
its maximum length is determined at sysgen 
time. 
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Contents is a variable-length field that must contain 


of message the message to be sent to the log device. 

Address of is a 4-byte field that must contain the 
message starting address of the buffer that contains 
buffer the message to be sent to the log device. 


This buffer can be on any byte boundary. 


When the message is sent to the appropriate log device, it is 
either formatted or in image mode. When a formatted message is 
sent to a device: 


@e All trailing blanks in the buffer or at the end of the message 
are eliminated. 


e A carriage return (CR) and line feed (LF) are automatically 
appended to the message. 


e The message terminates when the end of the buffer or message 
is reached or when a CR is found in the message. 


When a message is sent to a device in image mode, the message 
terminates when the end of the buffer or message is reached. If 
in image mode, a message with multiple lines can be _ sent by 
executing a single SVC2 code 7 for each line. However, each line 
should include a CR and LF at the end. The image options should 
be used with caution because the amount of time that must remain 
for a CR to occur differs on various console devices. 


3.9.1 SVC2 Code 7, Option X'0Q0' 
If option X'00' is specified, the message specified in the 


parameter block is formatted and sent to the appropriate log 
device. 


Example: 
SVC 2, LOGMSG 
ALIGN 4 ; 
LOGMSG DB X'0O0',7 
DC H'32' 
DC C'OPERATOR-PLS MOUNT TPO28 ON MAG1' 
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Contents of message buffer before and after execution of SVC2 code 7: 


Pisa Sao ee eeteue ae eee eee eo Se ee ee Se eee ere a Se a ee ee eee Bre i a ee See ee 
(O1P JE IR JA IP 10-1R i= JP IL 18 | IW 10.10 IN I?) 40 ip t0 12 18:1 io IN | im4a10 14 | 


ee a ea a a a a a a a a a a a a ee ee ewe we we ee ww wn nt on ee 


Log device after execution of SVC2 code 7: 


OPERATOR-PLS MOUNT TPO0O28 ON MAGL 


3.9.2 SVC2 Code 7, Option X'‘'20' 

If option X'20' is specified, the message specified in the 
parameter block is formatted as for option X'00'. The message is 
then sent unconditionally to the system console. 


Option X'20' is used exclusively for tasks running under MTM. 


3.9.3 SVC2 Code 7, Option X'‘'40' 

If option X'40' is specified, the contents of the message buffer 
pointed to by the address specified in the parameter block are 
formatted and sent to the appropriate log device. 

3.9.4 SVC2 Code 7, Option X'60' 

If option X'60' is specified, the contents of the message buffer 
are formatted as for option xX'40'. The message is then sent 


unconditionally to the system console. 


Option X'60' is used exclusively for tasks running under MT. 


3.9.5 SVC2 Code 7, Option X'80' 
If option X'80' is specified, the message specified in the 


parameter block is in image mode and is sent to the appropriate 
log device. 
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Example: 


ALIGN 4 
LOGMSG1 DB X'80',7 
DC H'32' 


DC C'OPERATOR-PLS MOUNT TPO28 ON MAG1' 


F 
Q 
Zz 
> 


LOGMSG2 DB X'80',7 


Cont 
SVC2 


Log 


329). 


If o 


DC H'19' 
DC C'SET TAPE AT 800 BPI' 


14F{50145{52{41)54/4F 152} 2D|50)/4C{53{ 20} 4D] 4F)55/4E} 54; 20}54;50)30)32/38) 20/4F/4b{ 20{4D} 41) 46131};ASCII 


i 
iO IP jE {R JA {T 1O (TR i- (RP IL iS | IM {O (UU IN ([T { [T EP {O }2 {8 | lo IN | IM {A {G fl f{ 


ee ee a a a a a a a eee ee ee ee ee wee ew er rr eee ew ee ee ee ee 


ents of message buffer before and after execution of second 
code 7: 


cee ee ee eee ce ee me ee we ce rm ce ee ee ee ee eee ee ee a ee ee ce ee ee ee ee ee ee ee ee ee ee ee ee ee es 


Poet ee tombe Oras (Ot Uo Oe tor cOreei aye eOy eer Olas ASCII 


ee ce ce ee ee em mere cee es ae ee ee es ee ee ee oe ee ee ee ee ee ee ee oe ee ee ee oe ee ee ee ee ee ee ee ee ey ee eg ee 


Gevice after execution of second SVC2 code 7: 


SET TAPE AT 800 BPI TPO028 ON MAG1 


(no line feed appended, message overwritten) 


6 SVC2 Code 7, Option X'AO' 


ption X'AO' is specified, the message specified in the 


parameter block is in image mode, as for option X'80', but the 


mess 


Opti 


age is sent unconditionally to the system console. 


on X'AO' is used exclusively for tasks running under MTM. 
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3.9.7 SVC2 Code 7, Option x'Co' 
If option X'CO' is specified, the contents of the message buffer. 


pointed to by the address specified in the parameter block are in 
image mode and are sent to the appropriate log device. 


3.9.8 SVC2 Code 7, Option X'EO' 
If option X'EO' is specified, the contents of the message buffer 
are in image mode as for option X'CO', but the message is sent 


unconditionally to the system console. 


Option X'EO' is used exclusively for tasks running under MTM. 
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3.10 SVC2 CODE 8: INTERROGATE CLOCK 
SVC2 code 8 sends the current time of day to a _ user-specified 


buffer. This is accomplished earoug" the SVC2 code 8 parameter 
block shown in Figure 3-13. 


St me A LOS a a SY ye i: SOR om mY ee Ge ee meme em es ee eee em es hs me Ge mei mes ce ten es Soe wiles ed eS RY SS Oo GK men WY ND ANG mi NY eked Mmm ee 


i0(0) f1(1) 12(2) 
| Option H Code H Reserved 1 
ot 
oa-rieaiaiiaancae scm aelateaicnen carmen cian aor as ia ie ae cle ae aa | 
14(4) 
H Address of receiving buffer | 
J ! 
J ! 
SVC 2,parblk 
ALIGN 4 
parblk DB option,8 
DC H'O' 


DCF A(receiving buffer) 
Figure 3-13 SVC2 Code 8 Parameter Block Format and Coding 
This parameter block is eight bytes long, fullword 
boundary-aligned, and does not have to be located in a 


task-writable segment. A general description of each field in 
the parameter block follows. 
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Fields: 


Option This l-byte field must contain one of the 
following options: 


@ Option X'QO' returns the time of day as two 
fullwords of ASCII data _ in the form 
hh:mm:ss. 


@ Option x'g0! returns the time of day as a 
fullword of binary data indicating the 
number of seconds past midnight. 


@ Option X'40' returns the time of day as 
three fullwords of ASCII data in the form 
hh:mm:ss.sss. 


@ Option X'CO' returns the time of day as two 
fullwords of binary data. The first 
fullword indicates the number of seconds 
past midnight; the second fullword 
indicates the number of milliseconds past 


midnight. 
Code is a 1l-byte field that must contain the 
Gecimal number 8 to indicate SVC2 code 8. 
Reserved is a reserved 2-byte field that must’ contain 
zeros. 
Address of is a 4-byte field that must contain the 
receiving starting address of the buffer to receive 
buffer the current time of day. 


The current time of day is calculated as seconds from midnight 
(midnight equals 0) and is taken from the line frequency clock 
(LFC) maintained by the system. 

3.10.1 SVC2 Code 8, Option X'00' 

If option x'00' is specified, the current time of day is returned 
in ASCII format to a user-specified buffer located in a 


task-writable segment This buffer must be at least eight bytes 
long. The current time of day is returned as follows. 


Format: 


hh:mm:ss 
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Parameters: 
hh are two ASCII characters representing the 
number of hours. 


mm are two ASCII characters representing the 
number of minutes. 


ss are two ASCII characters representing the 
number of seconds. 
Example: 


Contents of buffer after execution of SVC2 code 8 option X'00' 
when the current time of day is 10:09:03: 


3.10.2 SVC2 Code 8, Option X'80' 

If option X'80' is specified, the current time of day in seconds 
from midnight is sent in binary format to a user-specified buffer 
located in a task-writable segment. This buffer must be at least 
four bytes long and aligned on a fullword boundary. 


Example: 


Contents of buffer after execution of SVC2 code 8 option X'80' 
when the current time of day is 10:13:48: 


36828 = 10:13:48 
(decimal) 


The contents of this buffer represent 36,828 seconds’ from 
midnight. 
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3.10.3 SVC2 Code 8, Option X'40! 
If option X'40' is specified, the current time of day is returned 
in ASCII format to a user-specified buffer in a task-writable 


segment . This buffer must be at least 12 bytes long. The 
current time of day is returned as follows. 


Format: 
hh:mm:s8:8s3s8 
Parameters: 
hh are two ASCII characters representing the 


number of hours. 


mm are two ASCII characters representing the 
number of minutes. 


ss are two ASCII characters representing the 
number of seconds. 


sss are three ASCII characters representing the 
number of milliseconds. 
Example: 


Contents of buffer after execution of SVC2 code option xX'40', 
when the current time of day is 10:41:32.8: 


' 31 | 30 } 3A | 34 } 31 } 3A } 33 | 32 } 3A } 38 } 30 } 30 } Hex 
lateistair a nit air ee p PauNRPEGM ala as uniy aaa a al cota oe ing iam ce 
Ecko 4 OO ; 44) 1 | - | 3 } 24 ' 81 043 +O f ASCII 
ioe ay eee eed eae fee See rn a ee ee 
hh mm $s sss 


3.10.4 SVC2 Code 8, Option X'CO0' 


If option xX'cCO' is specified, the current time of day in seconds 
and milliseconds from midnight is sent in binary format to a 
user-specified buffer located in a task-writable segment. This 
buffer must be eight bytes long and fullword boundary-aligned. 
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Example: 


Contents of buffer after execution of SVC2 Code 8 option X'CO' 


when the current time of day in ASCII is 10:41:32.8: 


a ee ee a a cree GE eS eR Ge ae Se Ge See eS ee eee cee ee es es ee en ee ee Oe ee ee ee ee ee ee eee ce ee oe 


— ee ee ee as ee ee cee ee YS ee ee ee ee ee) ee Se eee ee ee ee ee ee ee 


The contents of this buffer represent 38,492 seconds’ and 
from midnight. 


800ms 


3-38 48-038 FOO RO2 


3.11 S8VC2 CODE 9: FETCH DATE 
SVC2 code 9 sends the current date to a user-specified buffer. 


This is accomplished through the SVC2 code 9 parameter block 
shown in Figure 3-14. 


ee a ee ea am SRE Gm ORK eet Re mth em, Ment fee mete Me Anan een GES Stes Mey MR hee meee re cee Ge Gee ett Sete mee NS ete Sens mee Maen SE me Se te mS ne me ie oe, Re ae ee ee 


|0(0) 11(1) 12(2) | 
Option Code 1 Reserved 
| ' ' t 
decease thee tee Se se re = 
14(4) 
| Address of receiving buffer 

svc 2,parblk 

ALIGN 4 

parblk DB 0,9 
DC H'O' 


DCF A(receiving buffer) 


Figure 3-14 SVC2 Code 9 Parameter Block Format and Coding 


This parameter block is eight bytes long, fullword 
boundary-aligned, and does not have to be _ located in a 
task-writable segment. A general description of each field in 
the parameter block follows. 


Fields: 
Option is a l-byte field that must contain a 0 to 
indicate no options for.this call. 
Code is a 1l-byte field that must contain the 
decimal number 9 to indicate SVC2 code 9. 
Reserved is a reserved 2-byte field that must’ contain 


zeros. 
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Address is a 4-byte field that must contain the 

of receiving starting address of the buffer receiving the 

buffer current date. The buffer must be eight bytes 
long and located in a task-writable segment. 
The buffer can be located on any boundary. 


SVC2 code 9 sends the current date to the receiving buffer in 
either one of the following: 


Format: 


mn/dd/yy 
or 


ad/mm/yy 


Parameters: 


mm are two ASCII characters representing the 
month. 

dd are two ASCII characters representing the day. 

yy are two ASCII characters representing the 
year. 


When the system is installed, one of these formats is chosen as 
the default for all operations. To return the current date in 
the alternate format, use the DATE command at sysgen. 
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Example: 


ALIGN 4 
DATE DB . 0,9 
pc H'0! 
DCF A(BUF) 
ALIGN 4 
PAUSE DB 0,1 
BUF Ds 8 


Contents of receiving buffer after execution of SVC2 code 9 
when the current date in ASCII is 07/06/81: 


I ee ee 
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} SVvC2 


3.12 SVC2 CODE 10: TIME OF DAY WAIT 


SVC2 code 10 suspends the SVC calling task until a user-specified 
time of day occurs. Then the calling task resumes’ execution. 
This is accomplished through the SVC2 code 10 parameter block 
shown in Figure 3-15. 


mt mm ee ee ee ee eee ee ee wee es a ee ee ee 


10(0) i1(1) 12(2) 
' Option H Code 1 Reserved 
i 
AC ca ala ee aaa ae ii i a ae a ea a ee 
14(4) i 
Time of day 
| ! 

SVC 2,parblk 

ALIGN 4 

parblk DB 0,10 
DC H'OQ' 
DC Y'time of day' 


Figure 3-15 SVC2 Code 10 Parameter Block Format and Coding 


Tre SVC2 code 10 parameter block is eight bytes long, fullword 
boundary-aligned, and does not have to be _ located in a 
task-writable segment. A general description of each field in 
the parameter block follows. 


Fields: 
Option is a l-byte field that must contain a 0 to 
indicate no options for this call. 
Code is a  l-byte field that must contain the 
decimal number 10 to denote SVC2 code 10. 
Reserved is a reserved 2-byte field that must’ contain 


zeros. 
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Time of 
day 


is a 4-byte field that must contain a decimal 
number from 0 to 268,435,455 (228 -1) 
representing in seconds a specific time of day 
when the calling task is to start execution. 
The decimal number specified must be 
calculated in seconds from midnight. 


@e O seconds equals 00:00:00 a.m. (midnight ) 
of the current day. 


@ 86,399 seconds equals 23:59:59 p.m. of the 
current day. 


See Table 3-2 for a range of values in seconds 
and their corresponding time of day. Any 
value greater than 86,399 refers to days in 
the future. If the specified time of day has 
passed, the same time on the following day is 
assumed. 


TABLE 3-2 TIME OF DAY VALUES CALCULATED IN 


SECONDS FROM MIDNIGHT 


cm meek mem eae my ee en ee: Suen seem ee aecee ame come copy ome cone Sm Sm mm ee ey me mm ee ee es ee cee ee es ee ee ee ee ee ee 


i i 
| DAY | (MIDNIGHT) H (P.M. ) H 
H Bs SEesetsBVeSEBVBEBBEVBRRAIBwe TIC BBSRBVVOoSOST ST SESEERBRAGIBISEASS Sos = { 
lst 
{ (current) | 0 t 86,399 { 
1 | 
| 2nd | 86,400 H 172,799 i 
H | H 
{ 3rd ' 172,800 { 259,199 ! 
i | 
| 4th i 259,200 H 345,599 { 
i 
{ 5th H 345,600 ! 431,999 ' 
H H H 
H 6th | 432,000 ' 518,399 H 
| 
| 7th i 518,400 { 604,799 | 
. 
| H 
i; 3,107th } 268,358,400 |} 268,435,455* | 
} (maximum) | H (max imum) { 


TIME OF DAY TIME OF DAY 


( i 
1 1 
| 00:00:00 HOURS } 23:59:59 HOURS 
t i 


vem wee no eh ante GS A DS ES TD ND OS SS SO Le A ST SRS ee mS meee BEND AGES SUED aE Om eR Oe GEE iw! = nee ome ees me GD me omen Ge ae oe 


* 268,435,455 seconds equals 21:24:15 hours 
of the final day 
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After executing SVC2 code 10, the CC is set to indicate if the 
call was successful. The possible CC settings follow. 


Condition Code: 


{ Normal termination 
| Sufficient system space is unavailable; 
SS SSsSeteeeosS no wait occurred 


If this call is executed and insufficient system space exists, no 
wait occurs and the CC is set to 4 (V bit set). 


Example: 

SVC 2,WAITDAY 
SVC 2,PAUSE 
ALIGN 4 

WAITDAY DB 0,10 
DC H'O' 
DC F'12165' EQUAL to 03:22:45 AM 
ALIGN 4 

PAUSE DB 0,1 
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| SsVvc2 | 


3.13 SVC2 CODE 11: INTERVAL WAIT | 


SVC2 code 11 suspends the SVC calling task until a user-specified 
interval occurs. When the specific interval elapses, the calling 
task begins execution. This is accomplished through the SVC2 
code 11 parameter block shown in Figure 3-16. 


ee ee ee ee See cee eee me ee See ee me ee ne eS ee ee ee NS Gees GE Mae me Ge Be GS ae me. me iy ame meee Re eRe ete Se eee ere Sm ee ee eee omen Se me emis ene ine Gis ta ee es oo 


10(0) }1(1) |2(2) | 
H Option H Code | Reserved H 
{ i] t i] 
leh oe bee ae, AT MOONS AT ATR ON ! 
14(4) 
Interval 

Svc 2,parblk 

ALIGN 4 

parblk DB 0,11 
DC H'OQ! 
DC F'interval' 


Figure 3-16 SVC2 Code 11 Parameter Block Format and Coding 


This parameter block is eight bytes long, fullworad 
boundary-aligned, and does not have to be _ located in a 
task-writable segment. A general description of each field in 
the parameter block follows. 


Fields: 
Option is a l-byte field that must contain 0 to 
indicate no options for this call. 
Code is a l-byte field that must contain the 


decimal number 11 to indicate SVC2 code ll. 
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Reserved is a reserved 2-byte field that must contain 
zeros. 


Interval is a 4-byte field that must contain a decimal 
number from 0 to 268,435,455 (29! -1) 
representing in milliseconds the interval that 
must elapse before the calling task resumes 
execution. The interval starts when this call 
is executed and ends after the specified 
milliseconds elapse. 


After executing SVC2 code 11, the CC is set to indicate if the 
call was successful. The possible CCs are: 


Condition Code: 


pCi iVvViGiLy 

H =n SS ee ha ow | 

i;Oj;oj;o ; 0 {| Normal termination 

; OO; 1 {0 ; Oj Sufficient system space is unavailable; 


Sa a ee no wait occurred 


If this call is executed and insufficient system space exists, no 
Wait occurs and the CC is set to 4 (V bit set). 


Example: 
SVC 2,WAITINT 
SVC 2,PAUSE 
ALIGN 4 

WAITINT DB 0,11 

DC H'O' 
DC F'32768' EQUAL TO 32.768 SECONDS 
ALIGN 4 


PAUSE DB 0,1 
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} SVC2 


3.14 SVC2 CODE 14: INTERNAL READER 


SVC2 code 14 allows a foreground task loaded from the system 
console to invoke operator and CSS commands. These commands are 
sent to the command processor where they are executed as if they 
were entered from the system console. SVC2 code 14 provides two 
options for sending commands to the command processor. Option 0 
allows the user to place the commands directly in the task 
command buffer field of the SVC2 code 14 parameter block. Option 
1 allows the user to store the commands in a task command buffer 
located on a fullword boundary within the task's address space. 
The address of this buffer is placed in the parameter block. 


SvC2 code 14 transfers the commands in a task command buffer 
until the end of the buffer is reached. The parameter blocks for 
both SVC2 code 14 options are described in the _ following 
sections. 


3.14.1 SvC2 Code 14, Parameter Block for Option 0 


The parameter block format for option O of SVC2 code 14 is shown 
in Figure 3-17. 
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ee ee ee ee cS ee ee cs ce ee eee dee ee ee ee ee es ee ee ee ee ee ee ee em tS ee ee 


10(0) 11(1) 12(2) | 
Option Code Status 
| | | | 
 eerieatetenetacereanaleteresierenananatenatatanataratateoatstuveiannaetetelenaneaiaiataae aetna | 
14(4) 16(6) Maximum system 
User command command buffer 
buffer length H length 
racarieteteteatetatetetetatateteetetatetatetataietatatatatattatrtaiatataiatatasiistenatatanataraEraTaaae | 
18(8) 
! | 
| 
a 
1 12(C) 
Task 
command 
(SS DUEECr 0000 «areata | 
}16(10 
ea 
| 

Svc 2,parblk 

parblk DB 0,14,0,0 

DC H'user command buffer length' 

DC H'O' 

DC ‘operator commands' 


Figure 3-17 SVC2 Code 14 Parameter Block Format and Coding 


for Option 0 


This parameter block can be up to 1,032 bytes long. It must be 


aligned on 
segment. 


a fullword boundary and located in a task-writable 
A general description of each field in the parameter 


block follows. 
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Fields: 


Option is a l-byte field that contains a value of 0 
to indicate that the task command buffer is 
contained in the SVC2 code 14 parameter block. 

Code is a l-byte field that contains the decimal 
value 14 to indicate SVC2 code 14. 

Status is a 2-byte field that receives a status code 


User command 
buffer length 


indicating the status of the SVC processing. 


is a 2-byte field specifying a decimal number 
indicating the maximum length allowed for’ the 
user command buffer. 


Max imum is a 2-byte field to which the operating 
system system returns the system command buffer 
command length established by CMDLEN at sysgen. This 
buffer value is returned only for status code 
length X'0003' (see Table 3-3). 


Task command 


buffer 


is a variable length field with a maximum 
length of 1,024 bytes. This field contains 
the commands to be sent to the command 
processor. 


3.14.2 SVC2 Code 14, Parameter Block for Option 1 


The parameter block format for option 1 of SVC2 code 14 is shown 
in Figure 3-18. 
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— a oe we ee ee ee ee ee ee ee eee ee ee ee ee ee ee ee ee ee ee eee ee eee eee eee eee 


10(0) $1(1) 12(2) 
i Option Code Status 
| ea a nn nnn nn ern -——Se Se See ES eS eee eee eS eee eS eee H 
14(4) 16(6) Maximum system 
{ User command i command buffer ! 
H buffer length { length t 
| mm nn rr rrr rrr ee, Ae SG ES ee ee ES Se Sa ee i 
18(8) 
H Buffer address ] 
i) i 
' t 

SVC 2,parblk 

parblk DB 1,14,0,0 

DC H'user command buffer length‘ 

DC H'O' 

DAC BUFADR 


Figure 3-18 SvC2 Code 14 Parameter Block Format and Coding 


for Option 1 


This parameter block is 12 bytes long, fullword boundary-aligned, 
and located in a task-writable segment. A general description of 
each field in the parameter block follows. 


Fields: 


Option 


Code 


Status 


User command 


buffer 
length 


is a l-byte field that contains a value of 1 
to indicate that the parameter block contains 
the address of the task command buffer. 


is a l-byte field that contains the decimal 
value 14 to indicate SVC2 code 14. 


is a 2-byte field that receives a status code 
indicating the status of the SVC processing. 
See Table 3-2 for a list of the SVC2 code 14 
status codes. 


is a 2-byte field specifying a decimal number 


indicating the maximum length allowed for the 
task command buffer. 
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Max imum is a 2-byte field to which the operating 


system system returns the system command buffer 
command length established by CMDLEN at sysgen. This > 
buffer value is returned only for status code xX'0003' 


(see Table 3-3). 
Buffer is a 4-byte field specifying the address of 
address the task command buffer. This buffer must 


be located on a fullword boundary within the 
task's address space. 


3.14.3 SVC2 Code 14, Status Codes 


The status codes for each of the SVC2 code 14 options are listed 
in Table 3-3. 


TABLE 3-3 SVC2 CODE 14, STATUS CODES 


a ee ee lo ee a ee rt cr en ge ee eee el ie hn i ee ae he ee ee oe ey 


CODE { MEAN ING 
X'O000' | Successful completion - commands are sent to the 


command processor for execution. 


| 
| | 
| X'O001' {| No free internal reader buffers are available. H 
| X'O0002' |; Option error - invalid option is specified for SVC. } 
' { t 
( { ' 
; X'O0003' | User-specified the length of command buffer } 
{| incorrectly. 
] i 1 
t § ' 
| i The length of the maximum allowed system command H 
| buffer is returned to the maximum system command H 
i | Length field. 
i 
| X'FFFF' | 


No internal reader command buffers defined. 


3.14.4 SCV2 Code 14, Programming Considerations 


Support for the internal reader must be included in the system at 
sysgen. This is accomplished through the Sysgen/32 command, 
IREADER. See the OS/32 System Generation (Sysgen/32) Reference 
Manual. If the internal reader is not included at sysgen, an 
attempt to execute an SVC2 code 14 results in an execution error 
and an illegal SVC message is sent to the user console. 
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The internal reader requires a set of buffers to receive the 
commands sent to it by SVC2 code 14. The OS/32 operator command, 
IRBUFFER, is used to create command buffers for the internal 
reader. See the OS/32 Operator Reference Manual. The I[RBUFFER 
command can also be used to increase the number of command 
buffers when no free buffers are available (status code X'0001'). 
IRBUFFER can be used at any time if support for the _ internal 
reader has been generated into the system. 


The following program demonstrates the use of SVC2 code 14. 


Sample SVC2 code 14 program: 


SVC214 PROG SVC2,14 EXAMPLE 
SVC 2, COMMANDO SEND COMMAND 
LH 0, COMMANDO +2 WAS IT SUCCESSFUL? 
BNZ STOP NO - ERROR 
SVC 2, COMMAND 1 SEND COMMAND : 
LH 0, COMMAND 1+2 WAS IT SUCCESSFUL? 
BNZ STOP NO - ERROR 
svc 3,0 EOT 
STOP EQU x 
SVC 2, PAUSE PAUSE 
SVC 3,0 EOT 
ALIGN 4 
PAUSE DB 0,1,0,0 
ALIGN 4 
COMMANDO DB 0,14,0,0 DIRECT COMMAND BUFFER 
DC Z(4) 
DCX 0 
DC c' DM' 
ALIGN 4 
COMMAND1 DB 1,14,0,0 INDIRECT COMMAND BUFFER ADDRESS 
DC Z (CMDBUFFE-CMDBUFF ) 
DCX 0 
DC A(CMDBUFF ) 
ALIGN 4 


CMDBUFF DC C'$WR ** CSS CALL BY IREADER ***; CALLCSS .CSS 


CMDBUFFE EQU = 
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| SVvC2 


3.15 SVC2 CODE 15: CONVERT ASCII HEXADECIMAL OR ASCII DECIMAL 
TO BINARY 


SVC2 code 15, the inverse of SVC2 code 6, converts an ASCII 
decimal or hexadecimal number to an unsigned 32-bit binary 
number. Character strings can be input in either upper-or 
lower-case. 


The result is stored in the user register 0. This is 
accomplished through the SVC2 code 15 parameter block shown in 
Figure 3-19. 


er a See em ee Se Mee ee GRE Pete ee ee ioe SS ny iS it es EE EE SL tee mem Oe feet SEED cetacean ees nee SO mee Me me ee SD ee US RR Gere Dee iy Me Oe es Oe 


10(0) }1(1) 12(2) 13(3) | 
Option Code Reserved | User register | 
| | | | | 
svc 2,parblik 
ALIGN 4 
parblk DB option,15,0 
DB user register 


Figure 3-19 SVC2 Code 15 Parameter Block Format and Coding 


This parameter block is four bytes long, fullword 
boundary-aligned, and does not have to be _ located in a 
task-writable segment. A general description of each field in 
the parameter block follows. 


Fields: 


Option 7 is a l-byte field that must contain one of the 
following options: 


@ Option X'O00' converts ASCII hexadecimal to 
binary. 
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@e Option X'40' converts ASCII hexadecimal to 
binary, skips leading spaces. 


e@e Option xX'80' converts ASCII decimal to 
binary. 


@ Option xX'CO' converts ASCII decimal to 
binary, skips leading spaces. 


Code is a l-byte field that must contain the 
decimal number 15 to denote SVC2 code 15. 
Reserved is a reserved l-byte field and must contain 0. 
User is a l-byte field that must contain the 
register user-specified register number. This register 


should contain the address of the buffer that 
contains the ASCII hexadecimal or ASCII 
decimal number to be converted. This buffer 
can be located on any boundary. After 
executing SVC2 code 15, register 0O contains 
the result, and the user-specified register 
contains the address of the byte following the 
last number to be converted. 


The valid ASCII hexadecimal numbers are O through 9 and A through 
F. The valid ASCII decimal numbers are O through 9. Any 
character other than those ASCII hexadecimal and ASCII decimal 
numbers specified causes the conversion process to stop, the 
nonconverted byte address to be stored in the user-specified 
register, and the CC to be set to 0. The possible CC settings 
that can occur after executing SVC2 code 15 follow. 


Condition Code: 


fc;yviyiGoitkL } 

: ss SSS SSS a ee eS ST | 

; oto }o } 0 | Normal termination 

iO; O | O | 1 {| No numbers converted; register O contains 
i zeros 

iO}; 1; O f{ O {| Value of the number to be converted is 


Sr aa as greater than 2,147,483,647 (2 -1) 


3.15.1 SVC2 Code 15, Option X'00' 


If option X'O0O' is specified, the ASCII encoded hexadecimal 
number in the buffer specified by the address’ in the user 
register is converted to a binary number. The resulting number 
is stored right-justified in register 0O with the left-most 
Significant bits (MSBs) filled with zeros. 
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Example: 


Buffer before and after execution of SVC2 code 15: 


Starting 

address Address 
X'14E' ial han 
ant Fontan 


am em A em — — mo nam et en ee 


— nee ee eee lee Memes one SE ES SE wee el mee oe ee 


If a number other than a valid ASCII number is specified, that 
number is mot converted, and the address is’ stored in the 
user-specified register. 


If an ASCII. number is preceded by at least one space, no 
processing takes place, the contents of the user-specified 
register remain the same, register O contains all zeros, and the 
CC is set to l. 


If the value of the ASCII number is greater than 2,147,483,647 
(251 -1), the number is converted, the resulting number is stored 
right-justified in register O with the left-most significant bits 
truncated, and the CC is set to 4 (V bit set). 
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Example: 


Buffer before and after execution of SVC2 code 15: 


Starting address Address 
£752" las 
So a 


13 2/3 113 443 713 44/3 813 3]3 6/3 6/3 5{2 O; ASCII 


RS SD ee nee cS Se a ee a me ee ee ae ee ee 


I A 


Register O after execution of SVC2 code 15: 


Overflow oo --9---2-------- 
21 14 714 813 616 5} ASCII 


10 0/0 O70 14/5 Ci Hex 


ee meee ee ee ee ee ee ee ee ee oe 


ASCII number greater than 2°! -1 


3.15.2 SVC2 Code 15, Option X'40' 


If option X'40' is specified, the ASCII-encoded hexadecimal 
number in the buffer, specified by the address in the user 
register, is converted to a binary number with leading’ spaces 
ignored during the conversion. The resulting number is stored 
right-justified in register O with the left-most significant bits 
filled with zeros. 
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Example: 


Buffer before and after execution of SVC2 code 15: 


Starting 

address Address 
X'152' X'156! 
ee ~ oa 


2 —— <> mane ED mY A ED ee oY mn Mee ME Bee Mee ame cane wwe 


pc} viGciL 
| ==aaaasa eee eo | 
fo};o}o } O f Normal termination 


3.15.3  SVvC2 Code 15, Option x'80' 


If option X'80' is specified, the ASCII-encoded decimal number in 
the buffer, specified by the address in the user register, is 
converted to a binary number. The resulting binary number is 
stored right-justified in register 0 with the left-most 
significant bits filled with zeros. 
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If a character other than a valid ASCII decimal number 


is 


specified, that character is not converted and the invalid 


character address is stored in the user-specified register. 


Example: 
Buffer before and after execution of SVC2 code 15: 


Starting Address of byte 


address not converted Address 
=a ine x'154' X'156' 

Re eee eee Pl 
— pan Gla 


13 53/3 9/4 143 34/2 Oj; ASCII 


ee ee ee ee es ee ee ee ee ee 


oe lS ee eS ree 


Condition Code: 


ree cee ee come ee ee es es ee 


ormal termination 
SCII number greater than 2?! -1 


Pz 


—_— et a ae a ms Ww a ame oe en wow 


If a decimal number represented in ASCII code is preceded by 
least one space, no processing takes place, the contents of 
user-specified register remain the same, register 0 contains 
zeros, and the CC is set to l. 


3-58 48-038 FOO 


at 
the 
all 
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If the value of the ASCII decimal number is greater than 
2,147,483,647 (2°' -1), the number is converted, the resulting 
binary number is stored right-justified in register 0O with the 
left-most significant bits truncated, and the CC is set to 4 (V 
bit set). 


3.15.4 SVC2 Code 15, Option X'Cco' 


If option X'CO' is specified, the ASCII-encoded decimal number in 
the buffer, specified by the address in the user register, is 
converted to a binary number, with leading spaces ignored during 
the conversion. The resulting number is’ stored right-justified 
in register 0O with the left-most significant bits filled with 
zeros. 
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| SVvc2 | 


3.16 SVC2 CODE 16: PACK FILE DESCRIPTOR 


SVC2 code 16 formats a user-specified unpacked fd to the packed 
format used within the SVC7 parameter block (see bytes 8 through 
23 of the SVC7 parameter block). Figure 3-20 illustrates’ the 
SVC2 code 16 parameter block format. 


Re ee SS ES SR a SS SN SN eS eS mS ES ES mee te is ek iti Mine ee Oe Me Oe ee SY Ee) EK OY EY EE rind OUD OE CRE CI 


10(0) t1¢1) i2(2) 
Option Code H User register 
1 t ( { 
ee ae rE AOR Ree ee 8 OSS mei pee eae ee Oe Ae 
1 { 
14(4) 
H Address of packed fd area H 
ft ! 
} | 

SVC 2,parblk 

ALIGN 4 

parblk DB option, 16 
DC H'user register number' 


DCF A(packed fd area) 


Figure 3-20 SVC2 Code 16 Parameter Block Format and Coding 


This parameter block is eight bytes long, fullword 
boundary-aligned, and does not have to be _ located in a 
task-writable segment. A general description of each field in 


the parameter block follows. 


Fields: 


Option is a l-byte field that must contain one of the 
following options: 


e xX'OO' indicates the defauit volume is’ the 
user volume. 
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Code 


User register 


Address of 
packed fd 
area 
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@e xX'40' indicates the default volume is’ the 
user volume. Skip leading spaces. 


e xX'10' indicates the default volume is the 
system volume. 


@e X'50' indicates the default volume is the 
system volume. Skip leading spaces. 


@® xX'20' indicates the default volume is the 
spool time. 


@ xX'60' indicates the default volume is’ the 
spool volume. Skip leading spaces. 


@® xX'80' indicates there is no default volume. 


e xX'CO' indicates there is no default volume. 
Skip leading spaces. 


In a non-MTM environment, the default user 
volume is the same as the default system 
volume. Options X'OO' or X'40' are preferred, 
since they are compatible with normal usage in 
an MTM environment. 


NOTE 
The above options are intended for 


use by nonprivileged u-tasks only. 
These options pack fds that use 


the /P, /G or /S file 
classification. If a privileged 
u-task or e-task uses these 


options to pack an fd with a /P, 
/G or /S file classification, the 
resulting packed fd has an account 
number in its file class field. 
See Section 3.14.9 for the SVC2 
code 16 options for e-tasks or 
privileged u-tasks. 


is a 1l-byte field that must contain the 
decimal number 16 to indicate SVC2 code 16. 


is a - 2-byte field that must contain the 
user-specified register number containing the 
unpacked fd address. 


is a 4-byte field that must contain the 
address of the area that receives the packed 
file descriptor. 


The CCs set after packing an fd follow. 


Condition Code: 


oP SD Se Ee SE SS SS ae eee ee com om oe 


Normal termination 

No volume name present in unpacked fd 
.An account number or file class present 
in unpacked fd 

Syntax error present in unpacked fd 

No extension present in unpacked fd 


If more than one condition results from a pack fd operation, a 
combination of CCs are set. | 
NOTE 
When a period followed by no valid 
characters is specified in the unpacked 
fd, it is treated as an explicit request 


for an extension containing spaces. The 
CC is set to 8 (C bit set). 


All lower-case characters in the user-specified fd are converted 
to their equivalent upper-case characters after the pack fd 
Operation occurs. The entire user-specified fd (unpacked format) 
can be from 1 to 19 characters. Allowable characters are: 


e A through Z (upper-case) 
e a through z (lower-case) 
e O through 9 (numerics) 


@e selected special characters (symbols) 
The format of the user-specified fd is: 
Format: 


2}] cena Eel 


actno 
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Parameters: 


voln or dev: 


filename 


-ext 


is a disk volume or device name from one to 
four characters. 


is a filename from one to eight alphanumeric 
characters. 


is the extension name of from one to three 
characters, preceded by a period. 


are single alphabetic characters representing 
the file class. They are: P for private file, 
G for group file and S for system file. 


is an account number ranging from 0 to 65,535. 


The area receiving the packed fd must be 16 bytes long, fullword 


boundary-aligned, 


and located in a task-writable segment (see 


Figure 3-21). Since this area is identical to bytes 8 through 23 
of the SVC7 parameter block, these bytes can be designated as the 


receiving area. 


ce cue eee ees mee eee eee ae ur es ee ee 


ee ee ree ee eee me a ee ce eee ee me ee ee es ee Oe re ee me eee Ee Cee me ee me eee ee eRe ee ree ce wee ee ee ee ee ee cee ce ee me ee ee ee ee ee ee ee ee te 


me ee mS ee es me em. cee ee em eee cre ee ee een cree ee me cee mee mee rm cee ce me ae, ee ee ee ee ee ee ee ee ee ee ee es 


Filename oo |}  ----------------+- 


15(F) | 
File class/ | 
account number} 


3] 
*s 
cr 
® 
2] 
7) 
~- 
fe) 
2) 


0 ae Re ee ER EE ED em SS Se ee Ree BS OP ae ED ee ce Sere ED Ae EES GRU SES ae Eee RE A OS ER Lem eee ome Me ee eR ee ae oe oe 


Figure 3-21 Packed File Descriptor Area 
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Fields: 


Volume name is a 4-byte field that receives the packed 
or format of the volume name or device name. If 
device name the volume or device name is less than four 
bytes, it is left-justified with spaces 
(X'20'). If no volume or device name _ is 
specified, the user-specified option 


determines the result. 


Filename is an 8-byte field that receives the packed 
format of the user-specified filename. If the 
filename is less than eight bytes, it is 
left-justified with spaces (X'20'). If no 


filename is specified, this field is filled 
with spaces. 


Extension is a 3-byte field that receives .the packed 
format of the user-specified extension. If 
the extension is less than three bytes, it is 
left-justified with spaces (X'20'). If no 
extension is specified, this field is filled 
with spaces. 


File class/ is a l-byte field that receives the packed 
account format of the user-specified file class. Any 
number value other than P, G or S inthe file 


class field of the unpacked fd causes a syntax 
error. If no file class is specified in the 
unpacked fd, an S_ is returned in the class 
field of the packed fd when running under the 
Os. P is returned in the class field of the 
packed fd when running under MTM. 


NOTE 


If the SVC2 code 16 options for 
privileged tasks are used, an 
account number is returned to this 
field (see Section 3.16.9). 


After the pack fd operation occurs, the user-specified register 
contains the address of the byte following the unpacked fa. If 
a syntax error is detected, the user-specified register contains 
the address of the first byte of the unpacked fd. The following 
examples show the results of issuing an SVC2 code 16 for a task 
running under MTM. The default system volume is M300. 


When a device name is encountered in the user-specified fd, the 


pack fd operation returns spaces to the filename, extension and 
file class/account number fields of the packed fd. 
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Example 1 


Unpacked fa 


ASCII 


4 Di3 3/3 0:3 O'3 AI5 33/5 644 333 2};2 E{3 113 612 Fi5 O;2 O; 


User-specified register before packing fd: 


100};00{;01;18; 


Hex 


ee a ee ee ee me ee 


Packed fd: 


14 Di3 3/3 0/3 OF5 315 644 313 2)2 Of2 Of2 Oi2 O13 1/3 642 O}5 OF} 
Seco a a PP a 


ASCII 


User-specified register after packing fd 


100;00{01} 26; 


Hex 


Condition Code 


Normal termination 


3-65 
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Example 2: 


Unpacked fd 
address Address 
Se a ee 


14 Dj3 3/3 O13 O13 AJ3 1}5 6/4 3]/3 2);2 Ej}3 1}3 6/2 Fi5 Oj ASCII 


14 Dji3 313 OF3 OfF2 OF2 Of2 OfF2 Oj2 Oj2 O}2 O}2 Of2 Oj2 Of2 O}2 Oj} ASCII 


User-specified register after packing fd: 


No extension present in unpacked fd; 
Ssora aa SS a syntax error present in unpacked fd 


The unpacked fd contains a character that was interpreted as a 
field separator. 
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Example 3: 


Unpacked fd 


address Address 
ee X'1l1F! 
oe, a 


ne cme ee ee es ce ee we ee ee ee wee ee ee ee ee ee cree ee ee ee ee me ee ee ee rm me ee ee ee ee ee as ee ee ee ee ee ee es ee 


ee ee ee ee em oe ee 


ee ee ee ee ee 


14 Di3 313 0:3 OF5 3/5 64/2 OJ2 Oj2 Of 2 Of 2 O}2 Of2 OF 2 O;2 OFS Oj} ASCII 


x 
w 
o 
ie 
< 


— ae ee Oe ee ee) eee GD a eee EP 


No extension present in unpacked fd; 
wea meee eee syntax error present in unpacked fd 


The above example shows an illegal character within the filename. 
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Example 4: 
Unpacked fd: 


<a et ee EN Ge Ge On: ee So eee Ge eee oe oe ee ee eee 


14 315 2{4 4{5 2|2 E} ASCII 


ee mere cee nee ee nme mee ee cee me tee ee mt me me mee ee mee me em ees ee tree ee me ee es ee ee ee re es ee ce ee ee ee ees ee te oe 


— A ey ee eee ee ee ae 


No volume name present in unpacked format 


ee eee ee ee SS ee ee Me ee os ee 


The example above shows a default volume option with an explicit 
request for an extension containing spaces. 


Example 5: 


Unpacked fd: 


ne ee mee ee ey ee ee ee me me ree me nee ne ee ee ee ee es ee 


—_ et ae ae ee ne me coe oe a Se ee ee ee 


14 Di3 343 O13 OF5 OfF4 3/4 2/3 343 242 OF2 OF2 OF2 O'2 O}2 OFS 31 ASCII 
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Condition Code: 


No extention present in unpacked fd; 
a a al no volume name present in unpacked fad 


If a syntax error occurs, the scan of the unpacked fd terminates 
at the byte that caused the syntax error and the area receiving 
the packed fd is filled with indeterminate code. Check the CC to 
determine if a syntax error occurred. 


3.16.1 SVC2 Code 16, Option xX'0d0' 
If option X'00' with no volume name is specified, the default is 
the user volume. The first byte of the unpacked fd (currently 
pointed to by the user-specified register) is the starting 
location of the pack fd operation. 


The following examples use M67A as the default system volume. 


Example 1: 


Unpacked fd: 


ce me neem ee mm ee ce eee em ee ee me cme eee mm cee ee ee ere cm ce me ee es ms ee ree ee ce ce me nee me ee i ee ee ee ee 


14 Di3 61/3 7/4 1/4 3/4 8]/3 2/5 O15 2/4 Dj2 Oj;2 O}3 643 143 344 7} ASCII 


es scm ce eee cee a ae atte ney ee ee cite ects nt me cee mm my ie en ms meme SD ese es ee cee ee me ee em ee cee te ces ee ee ee 
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Example 2: 


Unpacked fd: 


ee cee ce ee ee me ete ee ce ree ee eee ey ce ce ee ee ce we meme re ee ee ee a eee ee ee ee et ee ee ee ee ee ee ee et et ee ee ee ee ee ee 


14 DI3 613 74/4 14/2 Of 2 O}2 O]2 OF2 OFF 2 OF 2 OF2 OF 2 O}2 O}2 Of{2 Of} ASCII 
t Oy ee ay er ee ee ! 
Po ge eg ae gy fee ep ag ee ES EO er PST OT Tp me ee eee tae eR ' 
i M{}6{7tA f | i | | | | { i | | 


No extension present in unpacked fd; 
eee lea ne a oe ar ee syntax error present in unpacked fd; no 
volume name present in unpacked fad 


As shown in the above example, if the first character in the 
unpacked fd is not valid, processing stops. The system volume 
name is the default, and the filename, extension and class fields 
are modified to blanks. 


3.16.2 SVC2 Code 16, Option X'40' 


If option X'40' with no volume name is specified, the default 
user volume and all preceding spaces are ignored. All spaces are 
ignored from the first byte of the unpacked fd (currently pointed 
to by the user-specified register) to the first character in the 
unpacked fd. 
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The following example uses M67A as the default user volume. 
Example: 


Unpacked fd: 


eee ee Ae Re cs ery Se: coe NT OE SE me ms ie ete mers Gm caro aes WO MD Se em ne cate cute GD SL try re me Ni ee ty ees es cee ee erm ee 


12 OF4 3/4 813 215 OF5 244 Dj2 E}3 6/3 1/3 3}2 F{4 7} ASCII 


: 
: 
: 
: 
. 
: 
: 
= 
: 


Ce dd dd ee ee ee 


14 Di3 6}3 714 1/4 3/4 8/3 2}5 OJ5 244 Dj2 0/2 Of3 6/3 1/3 334 7} ASCII 


;c}viG tL 4 
{ aS SSS SS SS SESS ST H 
ft Of; O }; O | 1 }{ No volume name present in unpacked fda 


3.16.3 SVC2 Code 16, Option X'10' 
If option X'10' with no volume name is specified, the default is 
the system volume. The first byte of the unpacked fd (currently 
pointed to by the user-specified register) is the starting 
location of the pack fd operation. 


The following examples use M300 as the default volume. 
Example 1: 
Unpacked fd: 


15 315 6)4 3/3 2}2 E}3 1/3 62 Fi5 O;} ASCII 
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Packed fd: 


i4 DI3 343 0/3 O15 3/5 644 3}3 2/2 Of2 Of2 Of2 O}3 1/3 612 OF5 ae ASCII 


ee at ee cae eee ee cs et ee ee ee cee ec ee mee eee ee ee wee eee ee ee ee ee ee ee ee ee ee ee ee ee een en eee ee ee 


No volume name present in unpacked fd 


Example 2: 


Unpacked fd: 


12 0/4 Di3 64/3 71/4 143 AJ5S 315 644 343 2/2 E{3 1/3 64/2 F{5 O} ASCII 


oe ce ee eae es eee ee cre ee ee ee ee ee ee ee ee ee ee es ee ee ae ee es ee ee ee ee eee ee ee oe oe 


a eT et eS A LY OS ee SE eA SS SD ect es Ae Sem es ee ee eS mee Oe eee ee ce ee ee es ee 


14 Di3 3/3 O13 OF2 Of2 Of2 O12 Of2 Of2 Of2 OF 2 Of2 Of2 Of 2 OF} 2 O} ASCII 


No extension present in unpacked fd; 
a a a rg syntax error present in the unpacked fd; no 
volume name present in the unpacked fd 


As shown in this example, if the first character in the unpacked 
fd is not valid, processing stops. The system volume name is the 
default and the filename, extension and class fields are modified 
to blanks. 
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3.16.4 SVC2 Code 16, Option xX'50' 


If option X'50' with no volume name is specified, the default. 
system volume and all preceding spaces are ignored. All spaces 
are ignored from the first byte of the unpacked fd (currently 
pointed to by the user-specified register) to the first character 
in the unpacked fd. 


The following example uses M300 as the default system volume. 
Example: 


Unpacked fd: 


me) ey me ee Goes em: eee Se me ie Mea ne em eee SS me SS Me es ee ee ee ee te ee oe ae 


i2 OF2 OfF2 O'5 44/5 3/2 El4 345 3}5 3/2 Fj4 7} ASCII 


Cee a ee Na ee A re a Re ce A ee ee ie ee ee Re ee ed) 


14 Di3 313 O73 OF5 4/5 372 OF2 Aj2 Oj2 Oj2 Oi2 O}4 315 345 344 7} ASCII 


! 
ee ea ee ee ee ee en a i a a ee ee ee 
' J 


OS OVO Bee 8 Od Ae Be 1G 4 


ee eee ee ee ee ee ee ee ee oe 


No volume name present in unpacked fd 


— nm ee ce em eee: GR ee ee Oe ee oem Soe aoe ae 


3.16.5 SVC2 Code 16, Option x'20' 


If option X'20' with no volume name is specified, the default is 
the spool volume. The first byte of the unpacked fd (currently 
pointed to by the user-specified register) is the starting 
location of the pack fd operation. 
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Example 1: 
Unpacked fd: 


15 315 6/4 345 445 3{5 4/2 Ej{4 3/4 144 Cj ASCII 


ee a ee rm re ce crm ee ee re ae re ee ee er ee ee ee ee ee ee ee ee ee re ee eee ee es ee 


15 343 343 0/3 O15 3/5 614 315 4);5 335 4)2 Of2 Of4 3)4 1/4 CIS Of} ASCII 


— a ee a wee ee ee ee ee ae oe 


No volume name present in unpacked fd 


ee ee ee ee eee ee ee ee ee ee ee ee 


Example 2: 


Unpacked fd: 


12 O}2 O'5 315 6/4 315 415 34/5 4)2 Ej{4 3/4 1);4 Ci} ASCII 


ee ee cee ne cr cree em ey rw umey ce mS cme me ees tee ces cme ec ee sme car ee ee me eee ee re ee ce eee ee ee ee ee ee ees 


— ee mee cre ee wt ee ree eee ee cm meee es eee ce ae ce ee ee eee wee ee oe ee ee ee eee ee ee ee ee ae ee ee ee ee ee es ee ee ee 
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Condition Code: 


Q 
< 


No extension present in unpacked fd; 
a a a aa = syntax error in unpacked fd; 
no volume name in unpacked fda 


As shown in this example, if no volume name is specified and the 
filename is preceded by at least one space, the spool volume is 
the default and the filename, extension and class fields are 
modified to blanks. 


3.16.6 SVC2 Code 16, Option X'60' 


If option X'60' with no volume name is specified, the default is 
the spool volume and all preceding spaces are ignored. All 
spaces are ignored from the first byte of the unpacked fd 
(currently pointed to by the user-specified register) to the 
first character in the unpacked fd. The default volume for the 
following examples is S300. 


Example 1: 


Unpacked fd: 


a ee ee Ken ee) 


15 3}3 313 O}3 0/4 934 CIS 415 31/5 442 0/2 0/2 OFS 415 3/4 BIS 3} ASCII 


ee ee em ee em ee me ee eee oe cme ee ee ee ee et ee ee ee eee ee ee ee ee ee ee eee eee ee ee eee ee 


a ee A ee Se ey eS ee GE ee Ge Ge Se wmte 
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Example 2: 


Unpacked fd: 


4 D!3 333 033 O74 914 CI5 415 345 442 0/2 O0;2 O'5 4;5 31/4 BSS 3} ASCII 
' 


No volume name present in unpacked fd 


If no volume name is specified and the filename is preceded by at 
least one space, all preceding spaces are ignored, and the 
default is the spool volume. The spool volume name and remaining 
fd are packed. 


3.16.7 SVC2 Code 16, Option X'80' 


If option X'80' with no volume name is specified, the contents of 
the volume name field before executing the pack fd operation is 
used as the volume name. The first byte of the unpacked fd 
(currently pointed to by the user-specified register) is the 
starting location of the pack fd operation. 


Example 1: 


Unpacked fd: 


eee me ee ee ee ee ree et ee ee ee eee ee ee ee 
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Packed fd location contents before pack fd operation: 


(3 013 0/3 O13 OFS 7/4 814 115 444 515 644 515 234 544 C{5 3)4 5} ASCII 


ee cr cam came ce ee re ees ee cme ee ee ree meee cee eee me ee mm ce mee en ee eee ee ee ee ee ee ee ee ee ee ee ee oe ee ee ee es ee ee oe ee ee ee ee oe 


me es ee ee ree me cme ee ee re ee ree cee meee re cae cme me eee me eee a ne ee ee ee ee ee ee ee ee ee ee ee ee ee 


- 
; 
: 
: 
: 
‘ 
7 
z 
: 
3 
: 


mk rm ee ce ee ee rm em cr eee mee me ee nee rem en ee me mere ee ee eee ee ee ee ee ee ee ee oe 


fre;ypvjcs.Lf 
| maa a SS SS SSS SS { 
; O } 0}; O ; L {| No volume name present in unpacked fd 


If a volume name is specified and is preceded by at least one 
space, that volume name is ignored and the contents remaining in 
the volume name field before executing the pack fd operation are 
used as the volume name. The filename, extension and class 
fields are modified to blanks as shown in Example 2. 


Example 2: 


Unpacked fd: 


12 O32 OF4 DI3 143 Of4 113 Al4 FI5 Of5 433 8}3 O}2 E}4 334 1}4 C} ASCII 


a ee ee 


15 313 313.013 O15 744 814 1/5 4/4 5/5 614 S{5 2/4 534 Ci5 344 St ASCII 


De ce ce eee ce ea we ee we me ee ee ee ee re ee a ee ee eee ee a ee er ee ee ewe 
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Packed fd after pack fd operation: 


a ee ee ee me ee ee ee ee eee ee ee a eee ee ee ee ee a ee a a a ee ee wee ee 


15 313 313 Of3 OF2 OF2 Oi2 Oi2 Of2 Of 2 OF2 OF 2 Oi2 Of2 OF2 Oj2 01 ASCII 


I 
| 
I 
I 
1 
| 
t 
! 
! 
1 
! 
1 
1 
| 
! 
1 
! 
! 
1 
1 
1 
| 
1 
I 
( 
I 
I 
| 
I 
| 
I 
I 
t 
! 
| 
| 
t 
! 
! 
1 
{ 
| 
! 
1 
| 
I 
t 
| 
| 
{ 
I 
I 
I 
I 
J 
1 
I 
! 
! 
! 
I 
1 
V 


No extension present in unpacked fd; 
SSeS es +See -== syntax error present in unpacked fd; 
no volume name present in unpacked fd 


If no volume name is specified and the filename is preceded by at 
least one space, the contents remaining in the volume name _ field 
before executing the pack fd operation are used as the volume 
name. The filename, extension and class fields are modified to 
blanks as shown in Example 3. 


Example 3: 


Unpacked fd: 


2 0/4 Fi5 O;5 413 84/3 Of2 EJ4 3}4 1/4 C} ASCII 


! 
(Oo; P;}; TT} Bi Ot. FOCAL SY 


'4 013 243 542 OFS 7/4 814 1]5 444 S15 614 SIS 214 544 CIS 344 5S} ASCII 


ee ce es em scm ee ce meee eect meee cre eee cee ee ee es rr ee ee es tee cee ee ee en es ee ee ee ee ee ee 


mee ems mae tees eee Sane GD mS ED ene DOD ee GSD GEE SD me ae ees GD SG Oe ee oe GD we ee Ge eee ele ee me wee ee ee ee me ee ce ee a ee ee ee ee ee et ee ee ee ee ee ee 


3-78 48-038 FOO RO2 


Condition Code: 


ee re ee eee ome ee ee ee ee ee ee 


I 
| 
I 
l 
| 
I 
ll 
i 
| 
t 
I 
I 
| 
il 
i 


No extension present in unpacked fd; 
SSS Se ee syntax error present in unpacked fd; 
no volume name present in unpacked fd 


3.16.8 SVC2 Code 16, Option X'CcOo' 


If option X'CO' with no volume name is specified, the contents of 
the volume name field before executing the pack fd operation are 
used as the volume name and all preceding spaces are ignored. 
All spaces are ignored from the first byte of the unpacked fda 
(currently pointed to by the user-specified register) to the 
first character in the unpacked fd. 


Example 1: 


Unpacked fd: 


15 OF5 214 Di2 E/3 6/3 1}3 3/2 Fi{5 O; ASCII 


— ee em se me ee ee ewe ce ee em oe ee eee ee ee ee ee ee ee ee ee ee ee ee 


ee ee ee ee ee ee ea ee a ee ee ee we ee ee ee we ea ea ee ree 


14 415 3j4 ote 315 714 814 115 414 535 644 5}{5 2{4 514 Ci5 3/4 5} ASCII 


'4 415 314 313 315 O}5 214 Di2 OF2 Of2 OF 2 OF 2 OF3 643 143 315 oi ASCII 


eee we ee et re ee ee ee we ee ee ee ee ee ea ee ee eee 
ee ee ae - 
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Condition Code: 


No volume name present in unpacked fd 


If a volume name is specified and is preceded by at least one 
space, all preceding spaces are ignored and that volume name and 
remaining fd are packed as shown in Example 2. 


Example 2: 


Unpacked fd: 


12 O12 O14 Di3 6/3 7/4 113 AIS O15 2/4 Dj2 E}3 6/3 1/3 342 F{S O} ASCII 
eae eg ae og er Gk emia are GET aA Ee Ga ae £ ee | 


(Mi 6;7;iAi:} Pi; RiMi. |} 6} Lt'3t S/d P| 


ea ce ee ee ee ee ee ce ee ee ee ee ee ee eee ee es ee ee ee ee ee ee ee ee ee es 


14 Di3 6/3 7/4 115 OF5 214 Dj2 Of2 O}2 Of 2 O12 O}3 613 1/3 345 OF} ASCII 
| om nnn nnn nnn nnn nnn nnn nnn nn nnn nn nnn nnn nnn nnn nnn nena | 
(MAGE PEALE ER VM PP ob 4 P64 be bP 


Pe VO Gal ay | 
;o}o};o !} 0 } Normal termination 


3.16.9 SVC2 Code 16, Options for Privileged Tasks 


Only privileged u-tasks, e-tasks and privileged diagnostic tasks 
(d-tasks) are allowed to pack an fd so that the resulting packed 
fd has an account number in its file class/account number field. 
A u-task becomes privileged if the account privileges task option 
(ACPRIVILEGE) is specified when the task is link-edited. 
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ACPRIVILEGE allows u-tasks to access files by account number 
rather than file class. The range of account numbers available 
to the task is O through 65,535, excluding 255. To access files. 
on account 255, the bare disk I/O task option (DISC) must also be 
specified when the task is link-edited. 


E-tasks always have account privileges. 


CAUTION 


IF THE OS/32 TASK LOADER HAS THE E-TASK 
LOAD OPTION DISABLED, ALL U-TASKS WILL BE 
DENIED ACCOUNT PRIVILEGES REGARDLESS OF 
THE TASK OPTIONS SPECIFIED BY LINK. 


The following SVC2 code 16 options are used by an  e-task, 
privileged d-task or privileged u-task to produce a packed fda 
that has an account number in its’ file class/account' number 
field: 


OPTION MEAN ING 
x'O8' Default volume is the user volume. 
X'48' Default volume is the user’ volume; skip 


leading spaces. 


X'18' Default volume is the system volume. 

X'58! Default volume is the system volume; skip 
leading spaces. 

X'28! Default volume is the spool volume. 

X'68'! Default volume is the spool volume; skip 
leading spaces. 

X'88' ' There is no default volume. 

X'Cc8' There is no default volume; skip leading 
spaces. 


When a privileged task uses one of the above options to pack an 
fad that has either an account number or file class in its file 
class/account number field, SVC2 code 16 returns an account 
number to the resulting packed fd and sets the G bit in the CC. 


If neither an account number nor a file class is specified in the 
unpacked fd, the file is packed with account number 0 (if the 
task is running at the system console) or the user's private 
account number (if the task is running under MTM). 
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} SVC2 { 


3.17 SVC2 CODE 17: SCAN MNEMONIC TABLE 


SVC2 code 17 compares a user-specified mnemonic character string 
to a table of previously defined mnemonic strings. If a match is 
found, the user-specified mnemonic character string is accepted 
as a valid mnemonic. The SVC2 code 17 parameter block is shown 
in Figure 3-22. 


es ee ee RY SS ee nee SS: NE NE Se See SY SS eS GS SE eS ees eee Se he Se NS ee mn Se ee GY Aire ite 


|0(0) }1(1) |2(2) 13(3) | 
Option Code User User 
} register 1 | register 2 | 
ies eouiig nein woe in peta aa mr aiig aiaaiaiian A pela dem | 
14(4) l 
Address of mnemonic table 
| | 

SVC 2,parblk 

ALIGN 4 

parblk DB 0,17 
DB user register 1, user register 2 


DCF A(mnemonic table) 
Figure 3-22 SVC2 Code 17 Parameter Block Format and Coding 
This parameter block is eight bytes long, fullword 
boundary-aligned, and does not have to be located in a 


task-writable segment. A general description of each field in 
the parameter block follows. 
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Fields: 


Option is a l-byte field that must contain O to 


indicate no options for this call. 
Code is a 1l-byte field that must contain the 
decimal number 17 to indicate SVC2 code 17. 
User is a l-byte field that must contain a 
register 1 user-specified register number. This register 


should contain the starting address of the 
buffer with the user-specified mnemonic 
character string. After executing SVC2 code 
17, this register contains the address of the 
byte following the user-specified mnemonic 
string or the unchanged starting address. 


User is a 1-byte field that must’ contain a 
register 2 user-specified register number. This register 
receives a decimal number from ad 8 to 


2,147,483,647 (23! -1) corresponding to the 
position of the mnemonic within the table that 
matches the user-specified mnemonic character 
string. If no match is found, this register 
receives a value of -l. The first position in 
the mnemonic table corresponds to a value of 


0. 
Address of is a 4-byte field that must contain the 
mnemonic starting address of the mnemonic table. This 
table must be defined before executing SVC2 code 17. 


The user-specified mnemonic character string can be any length 
but can only contain the following characters: 

e A through Z (upper-case) 

@ a through z (lower-case) 


@e 0O through 9 (can be used only after the first byte of the 
mnemonic ) 


@ Special characters (can be used only as the first byte of the 
mnemonic) . 


All lower-case characters that appear in the user-specified 
mnemonic character string are accepted as their upper-case 
equivalent. 


48-038 FOO RO2 3-83 


3.17.1 Building a Mnemonic Table 


The mnemonic table to be used in SVC2 code 17 must be defined in 
a standard format. The mnemonics entered in the table can be any 
length but can contain only certain legal characters: 


@® A through Z (upper-case) 


e 0O through 9 (can be used only after the first byte of the 
mnemonic) 


@ Special characters (can be used only as the first byte of the 
mnemonic ) 


The characters for each mnemonic in the table must be in 
contiguous order, beginning with the first character and ending 
with the termination indicator, X'00'. Every mnemonic entered in 
the table has a minimum abbreviation. Each character required 
for the minimum abbreviation must have an X'80' added to the 
character when the mnemonic is defined. The mnemonic table must 
be terminated by an X'OO' after the last mnemonic entry. See the 
example below. 


Example: 


TABLE EQU * 
DB C'G'+X'80',C'ET',xX'00' 
DB C'R'+X'80',C'E'+X'80',C'W'+X'80',C'IND',X'00' 


DB C'S'+X'80',C'T'+X'80',C'ART',X'‘00' 
DB X'00' 


When the table is assembled, a logical OR operation is performed 
on X'80' and the character associated with it. This sets bit 0 
of each character on which the OR operation was performed to 1. 
A bit setting of 1 indicates that it is a required character; a 
bit setting of O indicates that it is not a required character. 


3.17.2 Executing SVC2 Code 17 


When executing this call, the user-specified mnemonic’ character 
string is compared to each entry in the mnemonic table until a 
match is found. Once a match is found, the address of the byte 
following the user-specified mnemonic character string is stored 
in the user register specified by the user register 1 field of 
the parameter block. 
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The mnemonic's position (decimal number) within the table that 
matched the user-specified mnemonic character string is stored in 


the user register specified by the user register 2 field of the | 


parameter block. After executing SVC2 code 17, the CC is set. 


Condition Code: 


— oe ee ON ee Ce ee Ee RD ee Be ee Ge ee oun 


PC ;~VviGikL | 
| 2 Raa eee ss | 
; O}; O } O | O | Normal termination 
; O}; 1 | Oj}; O | User-specified mnemonic character string 
Shee ne ee ae Soe mare does not match any mnemonic in the table 
Example: 
LA 3,STRING 
svc 2,SCAN 
SVC 2,PAUSE 
ALIGN 4 
SCAN DB 0,17 
DB 335 
DC A( TABLE) 
STRING DB C'map' 
ALIGN 4 
PAUSE DB 0,1 
TABLE EQU x 
DB C'A'+X'80',C'"L'+X'80',C'LOCATE' ,x'00' 
DB C'M'+X'80',C'A'+X'80',C'P'+X'80',X'00 
DB C'T'+X'80',C'YPE',X'OO' 
DB X'OO' 


User-specified mnemonic string before and after execution of 
SVC2 code 17: 


Starting 
address 


— oe me eae mee Se Ge eae ee oe 
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Table (after assembly) before and after execution of SVC2 code 
17: 


— ae ome es ee co es, ee ms ee Ome eee eee eee eee es eee eS eS ee ee ee ee Se GS GD Oe GED GS Se Ee eS ome ee re ee ee ee ee ee ee ee oe oe ee oe 


iC Lic Ci4 Cj4 Fj4 344 14/5 444 540 OjC Dic 1j/D OO OD} 


AiLiLioft}c}aAittT i} E jo o| Mj} A} P j{O 0} 
Ea apr any ae A ie arr cc er NPR ef taf ae ad Ae Naeem 


D 415 9/5 O14 5/0 O;FO O} | | | 


see ee ee ee ee eee ee ee ee ee ee ee ee eG ee a ee ee ee eS ee ee ee ee oe 


User register 1 before execution of SVC2 code 17: 


oe ce me ee eS ee ee ee on ee 


— a Soe oe ee ae ae ee ee 


User register 1 after execution of SVC2 code 17: 


10 O0;0 O;O0 1;5 Bi Hex 


User register 2 after execution of SVC2 code 17: 


:0 0/0 O70 OFO 1} Hex 


Condition Code: 


If the user-specified mnemonic character string is compared to 
each entry in the mnemonic table and no match is found, the 
starting address of the buffer containing the user-specified 
mnemonic character string remains unchanged in user register 1. 
A decimal value of -1 is stored in user register 2, and the CC is 
set to 4 (V bit set). 
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Example: 


LA 3,STRING 

Svc —-. 22, SCAN 
SVC 2,PAUSE 
ALIGN 4 

SCAN DB 0,17 
DB 3,5 
DB A( TABLE) 

STRING DC C'AS' 
ALIGN 4 

PAUSE DB O21 

TABLE FQU * 
DB C'A'+X'80',C'L'+X'80',C'LOCATE' ,X'00' 
DB C'M'+X'80',C'A'+X'80',C'P'+X'80',X'00! 
DB C'T'+X'80',C'YPE',xX'0000' 


User-specified mnemonic string before and after execution of SVC2 
code 17: 


Table (after assembly) before and after execution 


17: 


User 


Starting 
address 


ee ee es ee ee 


ASCII 


of 


a eet Gee a eG Ae ee ee fate eee AY OEY Met Glen SE NS SUES SOUR Seay GE Mme Oem Mee SO me Glee ie eRe OS mee wee eben cee ee mee ie ce es ee ee ee eee ee i ee Oe oe 


Ce ee ee ee ee ee 
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SVC2 


Li? 


code 


User register 2 after execution of SVC2 code 17: 


et ee ee ee eT SS ee See 


If a nonalphanumeric character follows the first character in a 
user-specified mnemonic string, the nonalphanumeric character is 
treated as the end of the mnemonic. The address of the 
nonalphanumeric character is returned to user register 1. 


Example: 

LA 3,STRING 
SVC 2,SCAN 
SVC 2, PAUSE 
ALIGN 4 

SCAN DB 0,17 
DB Cees 
DC A( TABLE) 

STRING DB C'TY&E' 
ALIGN 4 

PAUSE DB 0,1 
ALIGN 4 

TABLE EQU ~ 
DB C'A'+X'80',C'L'+X'80',C'LOCATE' ,X‘'00' 
DB C'M'+X'80',C'A'+X'80',C'P'+X'80!' ,X'O00' 
DB C'T'+X'80',C'YPE',X'OOOO' 


User-specified string before and after execution of SVC2 code 17: 


Starting 
address 
ay aa so cas 


ee ee 


5 415 9}2 644 5; ASCII 


a ee eae ee a eee mime 
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Table (after assembly) before and after execution of SVC2 code 
17: 


Ce ee 


| 
D 4}5 9/5 0/4 5j/0 OjO O} H 


ee were es me renee me eee eee ee Sm SE i Me ee eee tm ae ee US Ge SR Gener Girne et GRA: Mr GES SUED Gee ete Mine Mem ie mene OES OO ee Gee. Om i mee me i ek ee eS 


A A ED OS RS A es mS eS ee SD eee ED GD mS Me GIS GE mene me Re Re ee eee eee AR SE SE ED we eet te em Re me eee omen nn A me 


i0 OFO OFO 1};5 8} Hex 


User register 1 after execution of SVC2 code 17: 


{0 O;O0 O;0 1}/5 Aj Hex 


— eee eee ee ee ee 


User register 2 after execution of SVC2 code lL: 


i0 Of0 O;O0 O}O 2} Hex 


ee ee ee ae ae ee SS a Se 


In the above example, the user-specified mnemonic "TY&E" is 


treated as "TY". The address of the byte following the 
user-specified mnemonic string is then X'15A', which is returned 
to user register 1. A decimal value of 2 is stored in user 


register 2, and the CC is set to 0. 
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{ SVC2 


3.18 SVC2 CODE 18: MOVE ASCII CHARACTERS 
SVC2 code 18 moves a specified number of ASCII characters from a 


sending buffer to a receiving buffer in memory. The SVC2 code 18 
parameter block is shown in Figure 3-23. 


one ee re ee ed) 


10(0) i1(1) 12(2) 13(3) 
i Option+n H Code | User User | 
| register 1 { register 2 | 
cla aaa ae a ca a a la le aac ae 
14(4) | 
H Address of terminating character string 
| 

svc 2,parblk 

ALIGN 4 

parblk DB optiont+n,18 
DB user register 1, user register 2 


DCF A(terminating character string) 


Figure 3-23 SVC2 Code 18 Parameter Block Format and Coding 


This parameter block is eight bytes long, fullword 
boundary-aligned, and does not have to be _ located in a 
task-writable segment. A general description of each field in 
the parameter block follows. 


Fields: 


Optiont+n is a 1-byte field that must contain the 
addition of the hexadecimal number specified 
for the option and the decimal number 
specified as n. 


e nis a decimal number ranging from 0 to 127 
indicating an explicit number of bytes in 
the ASCII character string that are to be 
moved to the receiving buffer in memory. 
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e@ Option X'OO'+n means no terminating 
character string is used. 


@ Option X'80' +n means a terminating 
character string is used. 


Code is a  l-byte field that must contain the 
decimal number 18 to indicate SVC2 code 18. 

User is a l-byte field that must’ contain a 

register 1 user-specified register number. This register 


must contain the starting address of the 
buffer containing the user-specified ASCII 
character string to be moved. After executing 
SVC2 code 18, this register contains the 
address of the byte in the sending buffer that 
follows the last moved character. 


User is a 1-byte field that must containa 

register 2 user-specified register number. This register 
must contain the starting address of the 
buffer that receives the user-specified number 
of ASCII characters being sent. This buffer 
must be located in a task-writable segment. 
After executing SVC2 code 18, this register 
contains the address of the byte in the 
receiving buffer that follows the last 
character received. 


Address of is a 4-byte field that must contain the 
terminating starting address of the user-specified string 
character of terminating characters. Each character of 
this string can be used to indicate the end of 
the ASCII character string to be moved. This 


field is only used when option xX'80' is 
specified. 


When SVC2 code 18 is executed, the specified number of ASCII 
characters are moved to the receiving buffer. The starting 
addresses of the sending and receiving buffers located in the 
user-specified registers are changed to the address following the 
last byte sent in the sending buffer and the last byte received 
in the receiving buffer. The CC is also set after executing SVC2 
code 18. The possible CC settings follow. 


Condition Code: 


Normal termination 
No terminating character found in 
Sl aT the ASCII character string 
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3.18.1 SVC2 Code 18, Option X'00'+tn 


If option X'00'+tn is used with a user-specified decimal number, 
that decimal number determines the number of bytes moved from the 
ASCII character string to the receiving buffer. After executing 
SVC2 code 18, user register 1 contains the address of the byte in 
the sending buffer that follows the user-specified number of 
ASCII characters that were moved. User register 2 contains the 
address of the byte in the receiving buffer that follows’ the 
user-specified mumber of ASCII characters just received. The CC 
is set to 0. 


Example: 
LA 1,ASTRING 
LA 2,RECBUF 
svc 2,MOVECHAR 
ALIGN 4 
MOVECHAR DB X'00'+17,18 
DB 1,2 
DS 4 
ASTRING DB C'FLORIDA* **VERMONT ' 
RECBUF DS 17 


User register 1 before execution of SVC2 code 18: 


Ss ee ee ee et ee ee oe ae me ome 


oe os te me | ow 


ASCII character string before and after execution of SVC2 code 18: 


Starting address Last byte Address 

ee to be moved X'}]73' 
aE 

ae ao Pena’ 


14 614 Cl4 PIS 2/4 9}4 4/4 1/2 Al2 A}2 AIS 614 515 214 Di4 F}4 E!S 4}2 0} ASCII 
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Receiving buffer after execution of SVC2 code 18: 


Starting address Address 
x! re X'184' 
Fone yi: 


14 644 Ci4 F{5 21)4 914 444 1/2 Aj2 Aj}2 A{S5 614 515 244 Di4 Fi4 E}5 4)2 O} ASCII 


User register 1 after execution of SVC2 code 18: 


10 OJO O{O 1j7 3} Hex 


— a ae Ree ree om See em Le ee a OR oe ey 


User register 2 after execution of SVC2 code 18: 


10 0;O0 OFO 118 4} Hex 


em ee eee ee te ee oe ee es mee ee 


3.18.2 Svc2 Code 18, Option X'80'+tn 


If option X'80'+n is specified, each character in the ASCII 
string is compared to each character in the terminating string 
before it is moved. A match indicates that the end of the ASCII 
character string to be moved was reached and the decimal number 
n, which specifies the number of characters to be moved, is 
ignored. The character or characters in the ASCII string that 
match the character or characters in the terminating string are 
not moved, and the SVC terminates. The CC is set to 0. 


The string of terminating characters can be any length and can 
contain any character but must be specified by the user as 
follows. 


Format: 


label DB m,C'xxx...x' 
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Parameters: 


label is the name of the terminating character 
string the user specifies. 


DB is the operation code, define byte. 

m is a decimal number indicating the number of 
characters in the terminating character 
string. . 

C xXx. «2X! is a character string indicating that the data 


enclosed in the single quotation marks are 
characters. 


Example: 
LA 3,ASTRING 
LA 5, RECBUF 
SVC 2 ,MOVECHAR 
SVC 2,PAUSE 
ALIGN 4 
PAUSE DB 0,1 
ALIGN 4 
MOVECHAR DB X'80'+17,18 
DB 3,5 
DC A(TSTRING) 
TSTRING DB 3,C'/&*' 
ASTRING DB C'FLORIDA*&/VERMONT' 
RECBUF DB 17 


ASCII character string before and after execution of SVC2 code 18: 


Starting 

address Characters matching Address 
sae a terminating character string X'173' 
ae Oe i iN 


ge ee ee ee ed 


14 614 Ci4 FI5 214 934 4/4 1/2 Aj2 612 Fi5 6)/4 515 244 Dj4 FJ4 E{5 442 Ot ASCII 
' 


ee ee ee ee ee ee ee ee ee eee 


User register 1 before execution of SVC2 code 18: 


10 O;O0 O;O 116 2] Hex 


ee eae noes nee ee ety cee et et es 
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User register 2 before execution of SVC2 code 18: 


10 OJO0 O;0 1}7 3} Hex 


we Ae eee A SD ED eee wee eee ST Se) ae ne eee ne 


Receiving buffer after execution of SVC2 code 18: 


Starting address Address 
a ie X'17A' 
oo mee 


ee ee re cere me me ee ee es ee ee ae ee se ee ee ee ee ee ee a ee 


14 614 Ci4 FI5 214 94/4 D4 1lj2 Of2 oe O{2 Of2 Of 2 OF2 OF2 Of 2 O}2 O}2 O} ASCII 


ee ee tee eee cee mee cme me om emcee ee ee ee mcm ae ee ee ewe ee ee cree ce ee ee ee wr ee ee we es ee 


User register 1 after execution of SVC2 code 18: 


Te ee Rl 


10 OJO0 O;O0 1}6 9; Hex 


User register 2 after execution of SVC2 code 18: 


10 O}0 O;O 1}7 A} Hex 


Terminating character string before and after execution of SVC2 
code 18: 


oe ees Gee eee oe ee ee ee Oe 


12 Aj2 6/2 Fj ASCII 


an oe ee SS ST ee SENS Sey St Oe) ee ee oe 


fco;jviGitLit 
\ o£ 5 5 fe te SS UE \ 
1o1o;o};o} 
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If option X'80' is specified and the ASCII character string does 

not contain any characters that match any terminating character, 

the decimal number specified as m determines the number of bytes. 
to be moved. The CC is set to 4 (V bit set). 


Example: 
LA 3,ASTRING 
LA 5, RECBUF 
SVC 2,MOVECHAR 
SVC 2,PAUSE 
ALIGN 4 
PAUSE DB 0,1 
ALIGN 4 
MOVECHAR DB X'80' + 17,18 
DB 3,5 
DC A(TSTRING) 
TSTRING DB 3,C*, $2" 
ASTRING DB C'FLORIDA*&/VERMONT ' 
RECBUF DS 17 


ASCII character string before and after execution of SVC2 code 18: 


Starting address Last byte Address 
a ace to be moved ee 


14 614 Ci4 FI5 244 914 444 1{2 Aj2 6)2 Fi5 644 Sj/5 2)4 Di4 Fi4 E{S 4/2 O} ASCII 
1 


—— —— — ae ae eee ee ee oe oe oe ome 


a a a oo oP a Le Se a = a vow 
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Receiving buffer after execution of SVC2 code 18: 


Starting 

address Address 
X'173' es a 
ee 


14 6:4 Ci4 Fi5 21:4 914 414 1{2 Aji2 6)2 Fi5 6:4 535 234 Di4 Fi4 E}5 4}2 O; ASCII 


User register 1 after execution of SVC2 code 18: 


10 OF0 O}0 1/7 4} Hex 


ed ee 


12 742 413 A} ASCII 
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} svc2 


3.19 SVC2 CODE 19: PEEK 


SVC2 code 19 provides five parameter block options that can _ be 
used to obtain and store task-related information. Each 
parameter block option obtains a different set of information 
from the system pointer table (SPT) and the TCB. Figures 3-21 
through 3-25 illustrate the five peek parameter block option 
formats. 


3.19.1 Parameter Block for Option xX'00' 
If SVC2 code 19 is executed with option X'00' specified in the 


parameter block option field, use the parameter block format in 
Figure 3-24. This option is used to obtain task information. 


ee ee et ee ee ee ee ee ee a ee ee eR Re Ee eee eee Oe eS ee eee 


10(0) 11(¢1) i2(2) Number of /3(3) Maximum jj} 
| Option | Code tlogical units |; priority | 
(00) (19) i (MPRI ) 
pe tena SS Se ee ea ae eee SS ae een ee ee ee 
14(4) 
' i) 
i t 
| Name of operating system i 
(oSeeS Se Shee a= (OSID) °° Se See eo H 
18(8) | 
i | 
! | 
a er eS ee ee ee eR ee Se ae ae re | 
112(C) 
i i 
i 1 
fesse SSeS reals TASK: NAME» <SSsSSreesereoer=- H 
116(10) 
i i 
(SS Se Rg Sp i a a re ae oe 1 
120(14) 
Current task status word 
i (CTSW) | 
[Sr eS Sar SSS ee SSS sss SSS eee TS ee See Sree Sere | 
124(18) 1} 26(1A) 1} 27(1B) } 
H Task options { Logical | H 
{ (OPT) { processing H Reserved | 
i H unit (LPU) | | 

SVC 2,parblk 

ALIGN 4 

parblk DB x'00',19 
DS 25 
DB 8) 


Figure 3-24 SVC2 Code 19 Parameter Block Format and Coding 
for Option x'‘'00' 
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This parameter block must be 28 bytes long, fullword 
boundary-aligned, and located in a task-writable segment. A 
general description of each field in the parameter block follows. | 


Fields: 

Option is a l-byte field that must contain the 
hexadecimal number X'O0O'. 

Code is a l-byte field that must contain the 
decimal number 19 to indicate SVC2 code 19. 

Number of is a l-byte field that receives from the TCB 

logical units the maximum logical unit number that can 
be assigned to a task. This hexadecimal 
number ranges from 0 to 254 (X'FE'). 

Max imum is a l-byte field that receives from the TCB 

priority the highest priority number at which the 

(MPRI ) assigned task can execute. This hexadecimal 
number ranges from 10 (X'04') to 249 (X'F9'). 

Name of is an 8-byte field that receives from the 

operating SPT the operating system name in ASCII. 

system 

(OS ID) 

Task name is an 8-byte field that receives from the TCB 


the name of the task in ASCII. 


Current task is a 4-byte field that receives from the tTCB 


status word the hexadecimal number representing bits 0 
(CTSW) through 31 of the CTSW. 

Task options is a 2-byte field that receives’ the 
(OPT) hexadecimal number representing bits 16 


through 31 of the option field in the TCB. 
Bits O through 15 are accessible through 
option X'03' of SVC2 code 19. Table 3-4 lists 
task options. 


Logical is a l-byte field that receives the 

processing decimal number of the task's current LPU 

unit (LPU) assignment from the TCB. The value of this 
number ranges from xX'00' to xX'09'; x'00' 
indicates the central processing unit (CPU). 

Reserved — is a reserved l-byte field that must’ contain 
zeros. 
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TABLE 3-4 TASK OPTIONS FROM THE TCB 


BIT BIT NAME 
POSITION |} AND MASK 


BIT SETTING AND MEANING 


H 0 | D-task O = task determined by bit 16 
| 


= 
il 


| (¥'8000 O000') task is a d-task 


1 

' 
i 1 | Auxiliary | O = task can run on CPU or APU |} 
| {| processing } 1 = task cannot run on CPU { 
| } unit (APU) 
| i only | 
{| (¥'4000 OO000') | 
Tec ius Wag sie oe eka a nae ema domes ra ase rie eee oe | 
2 | APU } O = no APU mapping allowed 
| mapping | 1 = task can perform APU 
i (¥'2000 O000') | mapping functions 
Ta a ees lass et a cai a ciao aaa genoa ian aie Sao enn earees 
3 | APU i O = no APU control allowed 
| control i J. = task can perform APU 
i (¥'1000 O0000') | mapping functions 
ea a a a ea aoa 
H 4 | Dynamic |} O = dynamic priority 
| priority scheduling disabled 
; scheduling ; 1 = dynamic priority 
i} (Y¥'O800 OOOO0') | scheduling enabled 
i platen eda dele aaa a GET ine ge A LR RE | 
5 i Prompts | O = MTM prompts disabled 
i (¥'0400 O0000') |} 1 = MTM prompts enabled 
| Pee Season a ae ee | 
6 i; Vertical forms | O = except where specified, 
; control (VFC) | all 1/0 interpreted 
| (¥'O200 OO000') } without VFC 
} 1 = all I/O interpreted with | 
| VFC | 
asta anestaiestaetenstateiertrintr eerie pteceietatatenater ater atateneramataiaistanane ata aiataeiataraata | 
7 | Extended SVCl {| O = SVCl extended parameter 
H | parameter | block not used (excludes | 
H } block H communications I/O) | 
i : (¥'O100 OO000') | 1 = extended SVCl parameter H 
block used 
| Hetero n cen nnn neni ne enn nnn canamnasaanaaa= 
8 | Task event | O = new task status word (TSW) | 
; service for task event service 
i (Y¥'O0O80 0000') }; 1 = no new TSW for task event j| 
service | 
[OLS SSeS eS eres SS Sea ee Sea 

9 Task event O = all register contents 


J ! 
1 t 
} registers save | saved and restored 

i (Y¥'O0040 0000') } 1 = only contents of registers 
| that contain task event 

H | Gata are saved and 

H H restored 
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TABLE 


BIT 
POSITION 


| 
H 10 
| 
’ 


11 


15 


19 


3-4 TASK OPTIONS FROM THE TCB (Continued) 
BIT NAME H 
AND MASK H BIT SETTING AND MEANING 
Task event |} O = task event register not 
register save | saved 
(Y'O0020 0000‘) } 1 = task event register saved 
Vee eee eee ewes Pe Aaa 8d errno OIE aN REN OR erie ee eA Nee Davee ey 
System group i O = not in system group 
(Y'0010 O0000') | 1 = in system group 
Console I/0 {| O = no console I/O interrupt 
intercept } 1 = console 1/0 interrupt 
(Y¥'0008 OO000') | enable (MTM) 
Universal | O = universal task status re- 
status report } ports not allowed 
(Y¥'0004 OO000') {| i = universal task status re- 
| ports allowed 
E-task load | O = allow e-task load 
(Y'O0OO2 OOO00') | 1 = prevent e-task load 
Queued 1/0 } O = queued 1/0 not purged on 
(Y¥'OOO1 OOO0O0') } error 
} .L = queued 1/0 purged on error 
E-task ; O = task is a u-task 
(Y'OOOO 8000') ;| 1 = task is an e-task 
Arithmetic | 0 = task abnormally terminates 
fault 1 on arithmetic fault 
(y'0000 4000') | 1 = task continues execution 
1 on arithmetic fault 
Single preci- {| 0 = task does not support SPFP 
sion floating | 1 = task supports SPFP 
point (SPFP) 
(Y'O0O000 2000') |} 
Memory resident} 0 = task is nonresident 
(y'o00O0 1000') ; 1 = task is resident in memory 
SVC6 control | O = task can execute all SVC6 
functions { control functions 
(yY'0000 O0800') ;} 1 = all SVC6 control functions 
{ are prevented 
SVC6 communi- | O = task can execute all SVC6 
cation func-— { communication functions 
tions | L = all SVC6 communication 
{ 
1 
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(Y'0000 0400") 


functions are prevented 
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TABLE 3-4 TASK OPTIONS FROM THE TCB (Continued) 


ee ee ces ees me eee eS Sn ne Gn Ge ee Oe wee mm Mk me eee ce meee Se Gee ee ee ee ee oe me ce ee ee ee OS ee Oe A EE OS EE OD Ee Ae me Gen few Rene eS meee eee ee Se es ee 


{ BIT { BIT NAME | { 
{ POSITION } AND MASK H BIT SETTING AND MEANING H 
i es S=S5S55S 5 SS SS SE 2 2 Se ee ee es 2 2 a en 2 ee es 8 | 
22 i Illegal SVC6 | O = task abnormally terminates | 
| } (Y'O0000 0200') } on an illegal SVC6 H 
| 1 = task continues execution 
on an illegal SVC6 
eas ca a aa dlc a Ser SSeS aS aS se SS 
23 | Double preci- {| O = task does not support DPFP | 
| | Sion floating {| 1 = task supports DPFP t 
| | point (DPFP) | | | 
{ (Y¥'OO0O O0100') } | 
YE a ea ea ac a ay se a a see ee ee a cee 
H 24 { Rollable | O = task is not rollable H 
| i (Yy'O000 OO80') }| 1 = task is rollable { 
Pn en cn cnc ei, eso "ems wa anon { 
25 | Overlays | O = task does not support the | 
; (Y'OO000 O040') |} use of overlays H 
H H | 1 = task supports the use i 
H | { of overlays { 
oS ae aS Sala See ae SSS SS Se SSS ea SSS See H 
26 | Accounting i O = disable Accounting | 
| Facility { Facility ! 
| } (¥'OO000 0020') | 1 = enable Accounting Facility | 
[ESS te a See eee Se a a ee a ee i 
27 i Intercept calls} O = task cannot issue inter- 
H i (¥'OOOO O010') } cept calls H 
H H | 1 = task can issue intercept H 
| | calls H 
H ace eS ea at lara se a ing a a eget“ sane eis ao be cas Secs ese es eae a meee ae H 
| 28 } Account number }| O = task does not have file H 
| | privileges | account number privileges | 
| (Y¥'O000 0008') {| 1 = task has file account 
H | number privileges 
i use, etc S as eh gs ts Seem tbc es sats “esse Tela Sus ete, nc, Suns (Ss, “ela Ges an lV s-seb Sosa“ “Sas ces ass calc en? ee tas eh cea fe pl | 
29 | Bare disk I/O ; O = task cannot directly 
| | privilege H assign to a disk device H 
| i (¥'OOOO 0004') | 1 = task can directly assign | 
I H to a disk device for bare 
| disk 1/0 (see Chapter 8) 
| Hate eee ene me RR eee ae | 
30 i Universal i O = task is not a universal 
1 } communications | task ' 
| task i 1 = task is a universal task 
| (Y¥'OOOO O0002') | ! 
aa a a me a aa a aac 
3] |} E-task GO = no keys are checked on an 

H | keys assign for an e-task 

1 i) 

: ! 


{ 
J 
i] 
1 
(Y'OO000 O0001') | 1 = keys are checked on an 
H assign for an e-task 


et ee ns YN eR A ek eee a mS GD ee en men em OD ee em Ge A ss eee wnt te se eee ee i ee ee ee ee 
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Example: 


SVC2, PEEK 
SVC2, PAUSE 


ALIGN 4 
PEEK DB X'00',19 

DS 25 

DB 0 

ALIGN 4 
PAUSE DB O,1 


Parameter block before execution of SVC2 code 19: 


ee ee 


ee es 


Parameter block after execution of SVC2 code 19: 


oe ee ee eee ee ee see ee ee ee een oom 


a cee GD en ee dene eee ee ae ee ew 


OC84 = SVC6 control call prevented. 
SVC6 communication call prevented. 
Task is rollable. 
SVC6 load of e-task prevented. 
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3.19.2 Parameter Block for Option x‘'0l' 
To execute SVC2 code 19 with option xX'Ol1' specified in the 


parameter block option field, use the parameter block format in 
Figure 3-25. 


10(0 [1(1) 12(2) | 
{ Option | Code | Maximum blocking factor 1 
freee eens sara sae sa oe peer aes eee ae ea eee eee ees | 
14(4) ! 
| Name of operating system 
 Koteteetenieatesteteteatesteeetaten (OSID) = Pe Sse ree a ee =e =H | 
i8(8) 
L 
ee rae ee ig See ee pe ee Re 
112(C) {14(E) 
{ Operating system update { CPU model numbers H 
level (OSUP) H 
Pepe ae ae ene mse re ara er en es Ne tS ee eer 
}16(10) 
! System options 
(SOPT) 
(eee kanes oak a ein ec na Ses Carica aaa aie came 
120(14) }22(16) 
| User account number | Group account number | 
(UACT) H (GACT) | 
De ge ne ete aaa ee eer ee eg me ee ge ee ee 
1 24(18) 
' System console name | 
! ' 
' ( 

Svc 2,parblk 

ALIGN 4 

parblk DB X'0O1',19 
DS 26 


Figure 3-25 SVC2 Code 19 Parameter Block Format and Coding 
for Option X'Ol' 
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This parameter block must be 28 bytes long, fullword 
boundary-aligned, and located in a task-writable segment. A 


general description of each field in the parameter block follows... 


Fields: 

Option is a 1l-byte field that must contain the 
hexadecimal number X'Ol1'. 

Code is a l1l-byte field that must contain the 
decimal number 19 to indicate SVC2 code 19. 

Max imum is a 2-byte field that receives a number 

blocking ranging from xX'Ol' to X'FF'. This number 

factor indicates the maximum number of 256-byte 
segments that can be specified in an ALLOCATE 
command or an SVC7 for the data block size of 
indexed files, and for the indexed block size 
for indexed nonbuffered indexed and extendable 
contiguous files. This blocking factor must 
be set at sysgen. See the System 
Generation/32 (Sysgen/32) Reference Manual. 

Name of is an 8-byte field that receives from the 

operating SPT the operating system name in ASCII. 


system (OSID) 
Operating is a 2-byte field that receives from the 
system update SPT the current update level of the operating 
level (OSUP) system in ASCII in the form nn. 
CPU model is a 2-byte field that receives in hexadecimal 
numbers from the SPT the model numbers of the CPU used 
in the system. They are: 
e A Model 7/32 System has a value of X'0007'. 
e@ A Model 8/32 System has a value of X'0008'. 


@ A Model 3200MPS System has a value of 
X'OC80'. 


@ A Model 3205 System has a value of X'OC85'. 
e A Model 3210 System has a value of X'OC8A'. 
@e A Model 3220 System has a value of X'0C94'. 
e@e A Model 3230 System has a value of X'OC9E’. 
@e A Model 3240 System has a value of X'OCA8'. 


e A Model 3250 System has a value of X'OCB2'. 
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System is a 4-byte field that receives the 

options hexadecimal value of bits O through 31 of the 

(SOPT) options field in the SPT. Table 3-5 lists 
system options. 


User account is a 2-byte field that receives the user 

number account number from the TCB. This hexadecimal 

(UACT) number is right-justified with zeros filling 
the left-most portion. 


Group account is a 2-byte field that receives the group 


‘number account number from the TCB. This hexadecimal 

(GACT) number is right-justified with zeros filling 
the left-most portion. 

System is a 4-byte field that receives the name of 

console name the device that is acting as the system 
console. 


TABLE 3-5 SYSTEM OPTIONS FROM THE SYSTEM POINTER TABLE 


ene ee cee cree ce ee ee ee ee es ee ee ee es ee ces ee ee ee eee ee eee ee ee ee ee ee ee ee cee ee ee ee ee me ee ee cee ee ee ee ee ee ee ee es 


(¥'80000000' ) 


ee eee em ee ee ee et ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee wes ee ee en ee ee ee ee ee oe eee 


1 BIT BIT NAME H 
| POSITION } AND MASK H BIT SETTING AND MEANING { 
H SBVsTaBwBai Tas SS scSETVwKSCVSESVBSSTSIBESBwBSVTSEETESESABBSBESZEGESSSSBSSSSEBSETSSBSeSs S&S =z | 
i 0 | Single preci- { O = system does not support H 
H i Sion floating | SPFP } 
| point (SPFP) | 1 = system does support SPFP H 
{ 1 ( t 
! 
t t 


1 | Form date is i O = date is displayed in the 
| displayed form mm/dd/yy 
H i (¥'4000 0000') {| 1 = date is displayed in the H 
form dd/mm/yy 
i a eet Safe SS ea “nese te Main is oe pens wees Ste: Sas Ss ec eee Jud» Gae peels sss Skala A ee wean “se ca “nies “i lens fae ee em em en “ep mae H 
2 | Time display i; O + time is displayed on output | 
H i (¥'2000 O000') } device specified by the 1 
user 
; 1 = time displayed on panel 
stetclasietaratatotasetataiatetanetatanaaieranaatatasiancntanemaetanetattameanaeetamtaenmemmaman 
H 3 {| DPFP | O = system does not support 
I ' (¥'1000 O000') } DPFP 
| 1 = system does support DPFP H 
i) | ! ' 
ela a Bate Ue aes ean teint Sg : 
4 i Writable | O = system does not support WCS | 
; control store ;{ 1 = system does support WCS 
| | (WCS) | 
| | | 


(Y'0800 O000') 
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TABLE 3-5 SYSTEM OPTIONS FROM THE SYSTEM POINTER TABLE 


(Y'0400 0000') 1 = hardware supports address 


alignment error checking 


(Cont inued ) 
' BIT BIT NAME 
} POSITION j} AND MASK H BIT SETTING AND MEANING H 
| SS SS SSeS SRS SAS SSS SS SSS SSS SASS SSS SS SSeS ES SSE SBI ; 
5 | Address align- ; O = hardware does not support 
ment error H address alignment error H 
H | checking H 


J 
1 
' 
| checking 
' 
! 


en ne ee. me ere ene ME em Meme nen nets evens SY eet) me GS ne ee ete ety meme ees mets SS Se ees ttn memes Sn Sm tems SE Oe Gee OD i ete mem Se > ces EO Mt ces i OR SS Om ey Mim ES 


' 

! 

6 i Direct access {| O = system does not support 
i} (¥'0200 0000") } direct access 
H { 1 = system supports direct } 
1 | access 
a a ra aa a ee i | 
1 7 ; ITAM i O = system does not support 
| i (¥Y'O100 OO00') |} communications 1 
j H | 1 = system supports communica- | 
H tions 
[ear eae Sea aaa Sn eae SSeS eS eae Se 
H 8 } Spool | O = system does not support 
H i; (¥'OO80 OOO00') |} spooling 
} 1 = system supports spooling 
a naa ie tecgampioyeie sonia coats asa Coens salcinigia A ca quires sig gies IR ESE | 
9 i Roll i; O = system does not support 
i if (¥'0040 OO000') j; roll-in, roll-out 
| H ;} 1 = system supports roll-in, 1 
H H H roll-out 
a a la aaa ga a a 
10 i Temporary | O = system does not support 
H | files temporary files 
H | (Y¥'0020 0000') | 1 = system supports temporary H 
files 
learns uintaiakc oc ricnivisao si Sa RE es Re TE | 
11 | Multiple | O = system does not support 
| register sets | multiple register sets 
H i; (Y¥'0010 O0000') |} 1 = system supports multiple H 
H H H register sets 
{ a aR a Sa a a a a a a SS a i ass eae aes esd eva rcs meas tom“ es Yee Sn ea H 
12 | Universal {| O = intertask reporting between | 
| reporting universal tasks off 
| f (¥'o0008 O000') | 1 = intertask reporting between | 
| { H universal tasks on 1 
| ------- == = = no en enn nnn nnn nnn nnn nnn nnn 
13 | General error {| O = general error recording off | 
| recording | 1 = general error recording on | 
1 i (Y¥'0004 OO000') |} 1 
me em sens ee ce eens re ee mee ts wt my sce snes cme sm een Dee Ss cn ae mee ee sis soy ces ea ee mms enn es Sim am es eae mmm men es oes es nn SO em Ss ee se H 

14 Memory error 0 memory error recording off 


| O = 
| recording i} Ll = memory error recording on 
} (¥'O0002 OOOO') | 
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TABLE 3-5 SYSTEM OPTIONS FROM THE SYSTEM POINTER TABLE 


(Continued) 
H BIT { BIT NAME j { 
| POSITION } AND MASK H BIT SETTING AND MEANING i 
\ CoS SS VBS CSE AS SST RVABVSTSEEBVVBRSOoa CCLRC GEAIIT TI SUVA SSS SESSr AIS Ss STs SIS SS H 
15 | Reserved | O = reserved for future use 
[See S5 See SSeS Sea ae eS a ee ee ee ee re ee 
16 | Load real | O = load real address not 
| address supported | 
| (Y'O0O000 8000') ; 1 = load real address supported | 
lence to gaming ane eee ane aie ea ene eka el | 
1 17 | Memory | O = memory diagnostics 
I | Giagnostics supported 
i { (Y'OOOO 4000') {| 1 = memory diagnostics not H 
H H H supported | 
ringateiniias Maes smn GaMeaa a eo <a eee aTe rE Agr ee RES a | 
{ 18 | Processor {| O = Model 7/32, 8/32 Processors |} 
H | model { 1 = Model 3205, 3210, 3220, \ 
H ; ¢y'OOOO 2000') } 3230, 3240, 3250, 3200MPS H 
H | H System Processors H 
Nett deceo stitial srs gic asian cine aad @ agg Gini aia eas | 
i 19 | Memory address {| 1 = system has MAT hardware 
} translator | O - system does not have MAT 
{i (MAT) hardware | hardware | 
| ' ¢y'oo000 1000') } | 
[See SS SS See SS ee SSeS SS Se Sa aS | 
| 20 } SPFP traps | 1 = SPFP software traps present | 
| i functions H control functions H 
H i (¥'OOOO O800') | O = SPFP software traps not { 
1 1 | present H 
: ch i ad a a a a a a a occu a Cae ewan ee a ae Sc ey Nas H 
H 21 | DPFP traps | 1 = DPFP software traps present | 
H i (€Y¥'O0OO0O 0400') {| O = DPFP software traps not 
H present 
| Hee ene nnn UES RELA | 
H 31 | System debug | O = normal operation mode ! 
{| mode | 1 = system debug mode 
i } (Yy'oOOO0O OOO1') } H 
Example: 
SVC 2, PEEK 
svc 2, PAUSE 
ALIGN 4, 
PEEK DB X'01',19 
DS 26 
ALIGN 4 
PAUSE DB 0,1 
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Parameter block before execution of SVC2 code 19: 


101 119 {00 
[oa 00 00. 
100 00 OO 
arena 
Mar a Oe 
[00 00 100 
oo. 60. Gor 


Parameter block after execution of SVC2 code 19: 


eT 119 {00 
eres 
Iu to 
o 2 100" 


100 91 ;00 
ee ee es 
i Cc O N 
B2E08000 = 
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— son ame 


—_ 2 ae we 


SPFP 

Time display on hexadecimal display panel 
DPFP 

Direct access support 

Spooler option 

Roll option 

Temporary file support 

Multiple register set support 


Load read address support 
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3.19.3 Parameter Block for Option X'02' 
If SVC2 code 19 is executed with option X'02' specified in the 


parameter block option field, use the parameter block format in 
Figure 3-26. 


on ne AD SUS GRE MOE GUNS SE STS Ae GENES Gem SEN GA Ge feet edhe Gets no GD amin GE Mee GES mem GENS GD nes ieee EN Mn ce ES EE ED SUS GUND OE CONE GERD Gi GED CURD din ae GP GED cine Gum cee Sm GED ee ee ote Ge ow eo em 


10(0) }1(1) }2(2) 
| Option H Code | Reserved ‘ 
H 
a a ci a ik rl as i a sc a ee a ewe es { 
14(4) ! 
1 
[SoS Sc5=== Name of operating system 9 --~--33-----<--- 
18(8) (OSID) H 
J 
! | 
' i 
pos SSeS eee Sr Ses a a ea ee eS eee eee SS ee Se See Ses H 
{12(C) 
H Load volume H 
{ { 
| ! 
Serre SSS ee eae eee ee eee 
{16(20) 
| 
[oS Filename (eet sseeseese= 
120(24) 
2a sc ke naa aad rw H 
'24(28) {27(31) 1 
H Extension | File class H 
} 

SVC 2,parblk 

ALIGN 4 

parblk DB X'02',19 
DC H'O! 
DS 24 


Figure 3-26 SVC2 Code 19 Parameter Block Format and Coding 
for Option X'02' 
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This parameter block must be 28 bytes long, fullword 
boundary-aligned, and located in a task-writable segment. A 
general description of each field in the parameter block follows: . 


Fields: 

Option is a l1-byte field that must contain the 
hexadecimal number X'02'. 

Code is a l-byte field that must contain the 
decimal number 19 to indicate code 19 of SVC2. 

Reserved is a 2-byte field that is reserved and must 
contain zeros. 

Name of is an 8-byte field that receives from the 

operating SPT the operating system name in ASCII. 

system (OSID) 

Load volume represent the fd from which this task was 

filename loaded. The fdcan be used for subsequent 

extension assignments. 


file class 


Example: 

SVC 2, PEEK 
svc 2,PAUSE 
ALIGN 4 

PEEK DB X'02',19 
DC H'O' 
DS 24 
ALIGN 4 

PAUSE DB O,1 
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Parameter block before execution of SVC2 code 19: 


ee See ae See cee ES OS OS os es ee ee ee oe 


— a or a a se ee ee ee ee ee 


3.19.4 Parameter Block for Option X'03' 


To execute SVC2 code 19 with option X'0O03' specified in the 
parameter block option field, use the parameter block format in 
Figure 3-27. This option is used to obtain extended information 
on a task. 
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10(0) {1(1) 42(2) Number 

{ Option | Code i of logical 

i H i units 

| ee ee ee a oe ee ee 
14(4) 

| Taskid (TID) 

! 

Palen sala a a Ps Pen eta Seas hone 
18(8) 

| 

\ 

[sees SoeSee==> Task name 

112 (C) 

H 

| 

H (a <n rs esc “aS ws oi nema sh mk nn mS on’ i: is “neu ahs rl mS ihc gh, mt snc, ei enn, 
{16(10) 

| Current task status word (CTSW) 

| 

H ee ce rm ce ee ee cae em ee eee me ee eae me ee ee cee ee ee ne en ee ee ee eee oe oe we ee eee ee 
120(14) 

H Task options (OPT) 

i) 

enn aee ROPES SNE ATE Ok RIMM aT Oe tek EERE Lee PC eee 
124(18) 

H Task waits 

4 

teat ee ee ote ts tact 
128(1C) 

i User account number 

' 

fee tet stee Ale tone itt bho ee tee eal 
132(20) 

i Group account number (GACT) 

1 

ee ne Ae eek Se See STE NE eee ee I aE 
136(24) 

{ Load volume 

! 

i] 

| ee 
140(28) 

i 

H 

(Seas Filename 

{44(2C) 

| 

H 

| “ein a i es me je ef some emma Ts in in SS a eS Sn sc Se ape “ee a ea ee “mem gee 
148(30) 

| Extension 

! 

1 

| cbs ec as ms. Tes st Set ekg “et es igh ‘Snopes ah sun Sins vis. igi ls “<i “Gi, ag,‘ "si: a “ic: i “pela. <Ga ei ae hip Soe “aah 
152(34) 

i 

H 

| ---------- Monitor task name 

156(38) 

i 

H 

H rem eee eee reece 
160(3C) 


13(3) Maximum 
| priority 
' (MPRI ) 


§1(33) 


| Originating user console device (legacy) 


164(40) 
| Task 


H priority 


parblk 


165(41) ‘ 66(42) 
| Reserved | LPU 
' t 
(] t 


2,parblk 


4 
X'03',19 
2 
Y'utask' 
57 

ie) 

1 

(a) 


67(43) 
Reserved 


Figure 3-27 SVC2 Code 19 Parameter Block Format and Coding 
for Option X'03' 
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This parameter 


block must be 68 bytes long, fullword 


boundary-aligned, and located in a task-writable segment. A 
general description of each field in the parameter block follows. 


Fields: 


Option 


Code 


Number of 
logical units 
(NLU) 


Max imum 
priority 
(MPRI ) 


Taskiad 
(TID) 


Task name 


Current task 
status word 
(CTSW) 


Task options 
(OPT) 
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is a 1l-byte field that must contain the 
hexadecimal number X'03'. 


is a 1l-byte field that must contain the 
decimal number 19 to indicate SVC2 code 19. 


is a l-byte field that receives from the 
TCB the maximum number of logical units 
that can be assigned to a task. This 
hexadecimal number ranges from 0 (X'00') to 
254 (X'FE'). 


is a l-byte field that receives from the 
TCB the highest priority number at which the 
assigned task can execute. This hexadecimal 
number ranges from 10 (X'OA') to 249 (X'F9'). 


is a 4-byte field that contains a hexadecimal 
number supplied by the user that identifies 
the task for which the extended task 


information is being requested. The user 
obtains this number using the SVC intercept 
software. See the 0S/32 System Level 


Programmer Reference Manual. The user's own 
task can be examined by setting the TID field 
to 0. 


is an 8-byte field that receives from the’ TCB 
the name in ASCII of the task for which the 
extended task information is being requested. 
If the supplied TID is invalid or the task no 
longer exists, the task name field is set to 
binary zeros. 


is a 4-byte field that receives from the 
TCB the hexadecimal number representing bits 
O through 31 of the CTSW. 


is a 4-byte field that receives from tTCB 
the hexadecimal number representing bits 0 
through 31 of the task option field in the 
TCB. Table 3-4 lists task options. 
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Task waits 


User account 


number (UACT) 


Group account 
number (GACT) 


Load volume 


Filename 


Extension 


File class 


Monitor task 
name 


Originating 
user console 
device 


(legacy) 
Task priority 


Reserved 
Logical 


processing 
unit (LPU) 


Reserved 
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is a 4-byte field that receives the 
hexadecimal number representing bits O through 
31 of the task wait field in the TCB. Table. 
3-6 lists the wait status bit definitions. 


the user 
This hexadecimal 


is a 4-byte field that receives 
account number from the TCB. 
number is right-justified. 


is a 4-byte field that receives 
account number from the TCB. 
number is right-justified. 


the group 
This hexadecimal 


is the fd from which the task was’ loaded. 
After the task is loaded, the fd can be 
assigned to subsequent tasks. 

is the fd from which the task was’7 loaded. 
After the task ‘is loaded, the fd can be 
assigned to subsequent tasks. 

is the fd from which the task was’ loaded. 
After the task is loaded, the fd can be 
assigned to subsequent tasks. 

is the fd from which the task was’7 loaded. 
After the task is loaded, the fd can be 


assigned to subsequent tasks. 


the name of 
specified 


is an 8-byte field that receives 
the task that is monitoring the 
task. 


is a 4-byte field that receives the name of 
the MTM console from which the specified 
task was loaded. If the task is not running 
under MTM, this field contains zeros. 


is a l-byte field indicating the priority of 
the specified task at the time this call is 
executed. 


is a l-byte field that must contain zeros. 


is a 1-byte field that receives the 
hexadecimal number of the task's current 
LPU assignment from the TCB. The value of 


this number ranges from X'00' to X'09'; x'00' 
indicates the CPU. 
is a l-byte reserved field that must_ contain 
zeros. 
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TABLE 3-6 TASK WAIT STATUS BIT DEFINITIONS 


ee De ee tee ed ed 


BIT 
Fe ae a a eee eecacecuseaueee eee seatetuce, 
a 0-14 i Y¥'OO000 OOOO' | Reserved | 
| 18 | ¥0001 0000" | Intercept wait = | 
| 16 | ¥'0000 8000" | T/Owait | 
| 17 | ¥0000 4000" | Any 1OB wait | 
| 18 | ¥'0000 2000" | Console wait (paused) | 
| 19 | ¥*0000 1000' j Load wait | 
| 20} ¥"0000 0800" | Dormant | 
| 21 | ¥"0000 0400' | Trap wait | 
| 22 | ¥*0000 0200' | Time of day wait | 
| 23 | ¥"0000 0100' | Suspended | 
| 24 | ¥'0000 0080" | Interval wait | 
| 25 | ¥"0000 0040' | Terminal wait = | 
| 26 | ¥"0000 0020' | Roll pending wait = | 
| 27 4 ¥0000 0010" } Interrupt initialization (MIM) | 
| 28 | ¥"0000 0008" | Interrupt termination (MIM) | 
| 29 | -¥"0000 0004" | System resource connection wait | 
| 30. | -¥*0000 0002" } Accounting wait = | 
/ 31 «| ¥'0000 0001' | Reserved a sstst—~S ! 


ee liraetl onl ee ee ee ee 


NOTE 


If bits O through 30 are set to O, the 
task is active. 
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Example: 


svc 2, PEEK 
svc 2, PAUSE 


ALIGN 4 
PEEK DB X'03',19 
DS 2 
DC Y'OO' 
DS 57 
DB 0 
DS L 
DB 0 


Parameter block before execution of SVC2 code 19: 


' 
100 }00 }00 j00 } 


— a ey ee a ee ee ee ee ee Gee oe Ee ae 
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Parameter block after execution of SVC2 code 19: 


103 {19 {OF {81 | 


3.19.5 Parameter Block for Option X'04' 


Option X'04' accesses the license number and current’ sysgen 
version of the OS that is currently running on the system. To 
execute option X'04' of SVC2 code 19, use the parameter block 
format shown in Figure 3-28. . 
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0(0) i1(1) i2(2) 
Option Code Reserved 
4(4) 
8(8) 
12(C) 
16(10) 
Ss Operating system 0 2 wth = 
20(14) license number 
24(18) 
28(1C) 
32(20) 
36(24) 
sear ianiamha Operating system version number Be ee 
40(28) 
Svc 2,parblk 
ALIGN 4 
parblk DB x'04',19 
DC H'O' 
DS 40 


Figure 3-28 SVC2 Code 19 Parameter Block Format 


and Coding Option x'04' 
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This parameter block must be 44 bytes long, fullword 
boundary-aligned, and located in a task-writable segment. A 
general description of each field in the parameter block follows. 


Fields: 

Option is a 1l-byte field that contains the 
hexadecimal number X'04' indicating option 4 
of SVC2 code 19. 

Code is a l-byte field that contains the decimal 
number 19 indicating SVC2 code 19. 

Reserved is a 2-byte field that should contain zeros. 

OS license is a 32-byte (8 fullwords) alphanumeric field 

number that receives the license number of the 
operating system: e.g., E-0178. Data in this 
field is left-justified with trailing ASCII 
blanks (X'20'). 

OS version is an 8-byte (2 fullwords) alphanumeric field 

number that receives the version of the operating 


system that was specified by the user at 
sysgen: e.g., 613C.819. Data in this field 
is left-justified with trailing ASCII blanks 
(X'20'). 
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i SVC2 H 


3.20 SVC2 CODE 20: EXPAND ALLOCATION 


SVC2 code 20 affects only those tasks running under previous 
32-bit operating systems and should not be used in a multitasking 
environment. This SVC provides for compatibility with existing 
programs; no action is performed. The parameter block for this 
call is shown in Figure 3-29. 


A ees eel Menten Meeks em ey NNT Re SI Rm Sine Ren ine Gee Mn NE Sete Gems ee mete ed aD Pee ne Gm eit eens Gm US Gee erm Gn Mi eee OT me ms me ee es eee aes ey re mes ne ne ma ane tm re He ee ees 


Zr 
3 
@ 
RR 
e) 
Lm) 
NO 
on 
. 
ox 
“<¢ 
cr 
0) 
on 
js 
re) 
fe) 
a 
if) 


ot a a ee A NR A YS A] LED “OES ND SUE ORO REDS COED te Mem mM AD Mak GD nies vale a cee oS teh ame ms em me SN ame hth Lm Hm Aenea UE Am GE OE mele Jem been ame ey Ree he moe 


svc 2,parblk 


ALIGN 4 
parblk DB option, 20 
be H'number of 256-byte blocks' 


Figure 3-29 SVC2 Code 20 Parameter Block Format and Coding 


This parameter block is four bytes long, fullword 
boundary-aligned, and located in a task-writable segment for 
option xX'80'. A general description of each field in the 


parameter block follows. 


Fields: 
Option is a l-byte field that must contain option 
X'00' or X'80'. 
Code is a -1-byte field that must contain the 
decimal number 20 to indicate SVC2 code 20. 
Number of is an unused 2-byte field. 
256-byte 
blocks 
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The CC is set after executing SVC2 code 20. Possible ccs follow: 


Condition Code: 


specified 
Normal termination with option X'00' 
a am we me specified 


| Normal termination with option X'80' 
: 

' 

| 
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{| SVC2 


Q 
O 
0 
i 
No 
~ 


3.21 SVC2 CODE 21: CONTRACT ALLOCATION 


SVC2 code 21 affects only those tasks running under previous 
32-bit operating systems and should not be used ina multitasking 
environment. This call provides for compatibility with existing 
user programs; no action is performed. The parameter block for 
this call is shown in Figure 3-30. 


ee re re me mete mare ner nemesis A nee eee a ert Om Mh Nem ee Rene: Ginter Gm tie me es ee ey et: SR Gs at ws Me ea ee Oe 


Zr 
3 
© 
re 
fe) 
- 
N3 
[Sa 
vi 
o 
< 
ct 
@ 
ox 
= 
re) 
re) 
nr 
7) 


Ct a a eee ee ee ee ee ed 


SVC 2,parblk 


ALIGN 4 
parblk DB 0,21 
DC H'number of 256-byte blocks' 


Figure 3-30 SVC2 Code 21 Parameter Block Format and Coding 


This parameter block is four bytes long, fullword 
boundary-aligned, and does not have to be _ located in a 
task-writable segment. A general description of each field in 
the parameter block follows. 


Fields: 

Option is a l-byte field that must contain a 0 to 
indicate no options for this call. 

Code is a 1-byte field that must contain the 

: decimal number 21 to indicate code SVC2 code 

21. 

Number of is an unused 2-byte field. 

256-byte 

blocks 
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} SVvCc2 | 


3.22 SVC2 CODE 23: TIMER MANAGEMENT 

SVC2 code 23 performs five timer management functions used _ in 

coordination with real-time operations: 

1. Schedules the addition of a parameter to a task queue when a 
specified interval has elapsed (option X'00'). 


2. Waits until completing a specified interval (option X'80'). 


3. Schedules repetitive additions to a task queue as_ specified 
intervals elapse (option X‘'40'). 


4. Reads time remaining for the specified interval (option 
X'20'"). 


5. Cancels a previous interval request (option X'10'). 


Since the five options perform different functions, their 
parameter block formats and coding differ and are shown as 
separate parameter blocks. These operations are accomplished 


through the SVC2 code 23 parameter blocks shown in Figures 3-30 
through 3-34. 


3.22.1 SVC2 Code 23, Parameter Block for Option X'00' 


When specifying option xX'0O0', a timer interval is set up 
concurrently with the subsequent task executions. Then, an item 
with a reason code of X'09' is added to the calling task queue 
when the user-specified interval elapses. This is accomplished 
through the SVC2 code 23 parameter block for option xX'00' shown 
in Figure 3-31. See the 0OS/32 Application Level Programmer 
Reference Manual for information on the task queue. 
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ee en Se Ee See ee me ome Ge eee es Ge See oe 


A re SS met eee ee ve ees Gry une SES mes Ge pee amet oe er me ae Be coe ee ee, ee ee ee ree eee ee RS eT Mere ee. ee ee ee ee 


10(0) }1(1) 12(2) 13(3) | 
Option Code Reserved iUser register } 
t t I t ' 
eee ene eee Lee eee ee. eee eran ! 
14(4) ! 
H Increment of time+count H 
| | 

SVC 2,parblk 

ALIGN 4 

parblk DB X'00',23,0 
DB user register 
DC Y'increment of time'+F'count' 


Figure 3-31 SVC2 Code 23 Parameter Block Format and Coding 
for Option X'00' 


This parameter 
boundary-aligned, 


block is eight bytes long, fullword 
and Goes not have to be located in a 


task-writable segment. A general description of each field in 
the parameter block follows. 


Fields: 


Option 


Code 


Reserved 


User register 


Increment of 
timetcount 
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is a 1l-byte field that must contain the 
hexadecimal number X'O00'. 


is a l-byte field that must contain the 
decimal number 23 to indicate SVC2 code 23. 


is a l-byte field that must contain a zero. 


is a  l-byte field that must contain a 
user-specified register number . Bits 8 
through 31 of this register must contain the 
parameter portion of the item that is added to 
the task queue when the interval elapses. 


is a 4-byte field that indicates the number 
of seconds or milliseconds that must elapse 
before an item is added to the task queue. 


Tne first four bits contain a hexadecimal 


number indicating how the time period is to be 
calculated: 
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e ¥'OO000000' indicates that the time is 
calculated in seconds from midnight (time 
of day). 


e yY¥'10000000'! indicates that the time is 
calculated in milliseconds from the time 
this call is executed (interval timing). 


The remaining bits contain the count or 
decimal number indicating the number of 
seconds or milliseconds. 


A decimal number greater than 86,399 indicates 
days in the future. For a detailed 
explanation of time of day and _ interval 
timing, see Sections 3.11 and 3.12. 


Before executing this call, prepare the task to handle a task 
See the 0S/32 Application Level Programmer Reference 


queue trap. 
Manual. 


After the interval is started and the CC is set, the task 
continues processing or enters a trap wait state. Possible CCs 


follow: 


Condition Code: 


Interval started; normal termination 
Insufficient system space available 


eee 


TIMRQ 


TRAPWAIT 
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3,C'ABC! 
2,TIMRQ 
9, TRAPWAIT 


4 

X'00',23,0 

3 
¥'10000000'+F'30000' 
4 

Y¥'88000200' 

y'O' 
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If this call is executed and insufficient system space is 
available, no time period elapses, no item is added to the task 
queue and the CC is set to 4 (V bit set). If this call is. 
executed and the task is unprepared to handle this trap, no item 
is added to the task queue and the task has effectively lost an 
interrupt. 


If queue overflow occurs after the specified interval elapses, 
the end of task code is’ set to 1000 and the task terminates 
abnormally. 


If the interval is calculated as time of day and that specified 
time has already passed, the same time on the following day is 
assumed. 


3.22.2 SVC2 Code 23, Parameter Block for Option X'80' 


If option X'80' is specified, the calling task is placed in a 
timer wait state until a specified interval elapses. Nothing is 
added to the calling task queue. This is accomplished through 
the SVC2 code 23 parameter block for option X'80' shown in Figure 
3-32. 


| $1(1) 12(2) | 
H Option Code Reserved H 
| | | 
Wn a a a ec a a a ec a nett cy, Reems Saree, sw, wees smn mre ce Shin Se, gn Si, eh si a mt oe esa ot ote I 
1 J 
1 (4) 
H Increment of timetcount 1 
SVC 2,parblk 
ALIGN 4 
parblk DB = X'80',23 
DC H'O' 
DC Y'increment of time'+F'count' 
Figure 3-32 SVC2 Code 23 Parameter Block Format 
and Coding for Option X'80' 
This parameter block is eight bytes long, fullword 


boundary-aligned and does not have to be located in a 
task-writable segment. A general description of each field in 
the parameter block follows. 
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Fields: 


Option 


Code 


Reserved 


Increment of 
time+count 


is a l-byte field that must contain the 
hexadecimal value X'80'. 


is a l-byte field that must contain the 
decimal number 23 to indicate SVC2 code 23. 


is a reserved 2-byte field that must contain 
zeros. | 


is a 4-byte field that indicates the number 
of seconds or milliseconds that must elapse 
before the task is released from the wait 
state. The first four bits contain a 
hexadecimal number indicating how the time is 
to be calculated: 


e y'OOOO0000' indicates that the time is 
calculated in seconds from midnight (time 
of day). 


@e Y'10000000'! indicates that the time is 
calculated in milliseconds from the time. 
this call is executed (interval timing). 


The remaining bits contain the count Or 
decimal number indicating the number of 
seconds or milliseconds. A decimal number 
greater than 86,399 indicates days in the 
future. 


After the specified interval elapses, the task resumes’ execution 
with the instruction following SVC2. The possible CCs follow: 


Condition Code: 


{ 

' 

{ Internal started; normal termination 
| Insufficient system space available; 


Sas eee no wait occurred 


If this call 


available, 
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no 


is 


executed and insufficient system space is 


interval elapses, no item is added to the task 
queue and the CC is set to 4 (V bit set). 
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If the interval is calculated as time of day and that’ specified 
time has already passed, the same time on the following day is 
assumed. 


3.22.3 SVC2 Code 23, Parameter Block for Option X'40' 


If option X'40' is specified, items with reason code xX'09' are 
repetitively added to the calling task queue at user-defined 
intervals within a specific time period until the task terminates 
or cancels the time interval request with SVC2 code 23 option 
X'10. The user-defined intervals that are within a specific time 
period must all be specified the same way, either as time of day 
intervals or as interval-timing intervals. This is accomplished 
through the SVC2 code 23 parameter block for option X'40' shown 
in Figure 3-33. 


10(0) 11(1) 12(2) 
H Option } Code | Number of intervals \ 
H | H defined in table H 
| i as aa Se aes roel Fs eg ai Goon “es ml ius“ cen ls mescaline ce “anal atu fees“ alia fe pie! Cee. oat es nin ein! bw nae a, Sh ch lt ' 
14(4) 
| Increment of timetaddress of interval table \ 

SVC 2,parblk 

ALIGN 4 

parblk DB X'40' , 23 
DC H'number of intervals defined in table' 
DC Y'increment of time'+A(interval table) 


Figure 3-33 SVC2 Code 23 Parameter Block Format and Coding 
for Option x'40' 


This parameter block is eight bytes long, fullword 
boundary-aligned, and does not have to be _ located in a 
task-writable segment. A description of each field in the 
parameter block follows. 
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Fields: 


Option 
Code 
Number of 
intervals 
defined in 
table 


Increment of 
timetaddress 
of interval 
table 


is a l-byte field that must 
hexadecimal number X'40'. 


contain the 


is a 1l-byte field that must contain the 
Gecimal number 23 to indicate SVC2 code 23. 


is a 2-byte field that must contain the 
decimal number indicating the number of 
intervals the user defined in the table. 


is a 4-byte field that indicates the address 
of the table containing all the user-defined 
intervals within a specified time period. The 
first four bits contain a hexadecimal number 


indicating how the time designated by the 
interval table is to be calculated: 


indicates that the time is 
seconds from midnight (time 


e Y'0OO0000000' 
calculated in 
of day). 


e  ¥'10000000' indicates that the time is 
calculated in milliseconds from the time 
this call is executed (interval timing). 


The remaining bits contain a hexadecimal number indicating the 
address of the interval table. This table must be fullword 
boundary-aligned and defined as follows. 


Format: 


table DC F'count' First interval 
DC F'parameter' 
DC F'count' Second interval 
DC F'parameter' 
DC F'count' Last interval 
DC F'parameter ' 
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Parameters: 


table is the user-specified name for the _ interval 


table. 
DC is the operation code, define constant, for 


the instruction. 


F is the type code, fullword, for the 
instruction. 
count is the decimal number indicating how many 


seconds or milliseconds must elapse before an 
item is added to the task queue. The decimal 
numbers specified for time of day intervals 
can be any number except O and must be 
specified in ascending order with each count 
at least one greater than the previous’ count. 
The decimal number for interval-timing 
intervals can be any decimal number except 0. 
This decimal value occupies bits 4 through 31 
of the count field. 


parameter is the item to be added to the task queue when 
its associated interval elapses. This item 
occupies bits 8 through 31 of one slot of the 
task queuve. The first byte contains reason 
code xX'09'. See the O0S/32 Application Level 
Programmer Reference Manual. 


The time period in which the user-defined intervals occur differs 
for time of day intervals and interval-timing intervals. The 
time period for time of day intervals ranges from the day on 
which the first interval occurs through and including the day on 
which the last interval occurs. The time period is the sum of 
days on which the intervals occur. In the following example, the 
total time period is three days. 


Example: 

ALIGN 4 

INTABLE DC F'54000' 1500 hours of current day 
DC F'i' 
DC F'140400' 1500 hours of second day 
DC F'2' 
DC F'226800' 1500 hours of third day 
DC Et3? 
DC F'230400' 1600 hours of third day 
DC F'4! 


The time period for interval timing is the sum of all intervals 
in the table. 
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Example: 


ALIGN 4 
INTABLE DC F'18000' first interval 
DC F'AL' 
DC F'36000' 
DC F'A2' second interval 


In the above example, the time period is equal to 54000ms. The 
time period is repetitively executed until the task cancels the 
time interval request via SVC2 code 23 option X'10' or goes to 
end of task. Before executing this call, prepare the task to 
handle this trap as described in the OS/32 Application Level 
Programmer Reference Manual. 


As the specified intervals are elapsing, the task can continue 
processing. After executing this call, the CC is set to these 
possible settings: 


Condition Code: 


Normal termination 
Insufficient system space available; 
SSS SSS SSeS no wait occurred 


If this call is executed and insufficient system space is 
available, no interval elapses, nothing is added to the task 
queue, and the CC is set to 4 (V bit set). 


If this call is executed and the task is not prepared to handle 
this trap, nothing is added to the task queue. The task has 
effectively lost an interrupt. 


If queue overflow occurs after one of the specified intervals 
elapses, the end of task code is set to 1000 and the task 
terminates abnormally. 


If the time period is calculated as time of day and the specified 
time for the first interval has already passed, the same time in 
the following period is assumed. 


If the time period is calculated as time of day and one of the 


specified intervals in the interval table is O or not in 
ascending order, the task is paused and a message is displayed. 
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3.22.4 SVC2 Code 23, Parameter Block for Option X'20' 


SVC2 code 23 reads the time remaining until the _ interval. 
previously established with option X'00' or X'40' elapses. This 
is accomplished through the SVC2 code 23 parameter block for 
option X'20' shown in Figure 3-34. 


a es em ne pee HD see same Arm Re Gey GO ON, Mee Net Me ne i me tn SO St As Re Mee Ge I ee Ge OS Oe SO ee ee me eT mente) mens Se coms SE eee ene SE Oe ene met cine! eee me 


10(0) 11(1) 12(2) 13(3) 
Option Code Reserved iUser register | 
' t ' ' | 
ee ee Garter eae a te: tere a en mee Sere ee eer ! 
' 1 
i4(4) 
H Time returned 

SVC 2,parblk 

ALIGN 4 

parblk DB X'20',23,0 
DB user register 
DC Y'increment of time returned' 


Figure 3-34 SVC2 Code 23 Parameter Block Format and Coding 
for Option X'20' 


This parameter block must be eight bytes long, fullword 
boundary-aligned, and located in a task-writable segment. A 
general description of each field in the parameter block follows. 


Fields: 
Option is a l1l-byte field that must contain the 
hexadecimal number X'20'. 
Code is a l-byte field that must contain the 
decimal number 23 to indicate SVC2 code 23. 
Reserved - is a l-byte field that must contain a 0. 
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User register is a l-byte field that must contain the user 
register number. Bits 8 through 31 of this 
register should contain the parameter 
associated with the desired starting interval. 


Time returned is a 4-byte field that contains a hexadecimal 
number indicating how the time is returned for 
the type of interval being read, as follows: 


e Y'0O0000000' indicates the number of seconds 
from midnight specified for the time of day 
wait interval in the parameter block for 
option X'00' of SVC2 code 23. 


e ¥'10000000' indicates the milliseconds 
remaining from the time this call is 
executed to the completion of the time 
interval specified in the parameter block 
for option X'40' of SVC2 code 23. 


NOTE 


If the timer entry that is being 
read is set for a time of day wait 
interval (option X'00'), only the 
value for the time of day interval 
can be read. An interval timing 
readout cannot be made for this 
task. Similarly, if the task is 
set for interval timing (option 
X'40'), only an interval readout 
can be made. 


The register in the user register field specifies the parameter 
associated with the interval to be read. When executed, this 
call finds the value of the time of day wait interval or the 
milliseconds remaining for a timing interval by searching for the 
parameter associated with the interval on the timer queue. The 
value read is stored in bits 4 through 31 of the time returned 
field. Bits QO through 3 remain unchanged. Hence, the final 
value in the time returned field after execution of the SVC can 
be represented as follows: 


Time returned = increment of time + count 


If the interval was started with option X'40' specified and more 
than one interval in the table has the same parameter associated 
with it, the current time in the desired interval might not be 
the one that is read. Each interval must have a unique parameter 
associated with it. 
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After executing this call, the CC is set to the possible CCs 
following. 


Condition Code: 


se ee a me meen fm eee SO Mae Sines Oe mee 


fc yvVvi GiL 

| ct a me ee ce ee = oe | 

+O}; O | O } O {| Normal termination 

; O}; 1 {| 0; O {| No interval associated with parameter 2 

Bese Saree located in user-specified register 
Example: 


TEST1 EQU 1 
Lil 3,TEST1 
SVC 2,TIMRO 
SVC 2,RDTIME 
svc 9,TRAPWAIT 


ALIGN 4 
RDTIME DB X'20',23,0,3 
Dc ¥'10000000! 
ALIGN 4 
TIMRQ DB X'00',23,0,3 
DC Y¥'10000000'+F'90000' 


ALIGN 4 
TRAPWAIT DC ¥'88000200' 
DC ¥"0* 


3.22.5 SVC2 Code 23, Parameter Block for Option X'10' 


This SVC cancels an interval request that was previously 
established with option xX'00' or X'40'. This is accomplished 
through the SVC2 parameter block for option X'10' shown in Figure 
3=35. 
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10(0) f1(1) 12(2) 13(3) 
| Option | Code | Reserved {User register | 
H H H 
eaecigiacats sea oa 3 LL OE ee 
14(4) 
\ Increment of time cancelled i 
| { 
1 ' 

SVC 2,parblk 

ALIGN 4 

parblk DB X'10',23,0 
DB user register 
DC Y'increment of time cancelled' 


Figure 3-35 SVC2 Code 23 Parameter Block Format and Coding 
for Option xX'10' 


This parameter block is eight bytes long, fullword 
boundary-aligned, and does not have to be located in a 
task-writable segment. A general description of each field in 
the parameter block follows: 


Fields: 
Option is a 1l-byte field that must contain the 
hexadecimal number X'10'. 
Code is a l-byte field that must contain the 
decimal number 23 to indicate SVC2 code 23. 
Reserved is a l-byte field that must contain a 0. 


User register is a l-byte field that must contain the user 
register number. Bits 8 through 31 of this 
user register contain the parameter associated 
with the interval to be cancelled. 
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Increment is a 4-byte field that must contain a 
of time hexadecimal number indicating how time is 
cancelled being calculated for the interval to be . 

cancelled. The increments of time are: 


® Y'00000000' indicates seconds from midnight 
(time of day). 


e@ Y¥'10000000' indicates milliseconds from the 
time this call is executed (interval 
timing). 


When this call is executed, all previous interval requests that 
match both the increment of time specified and the parameter 
located in the user register are cancelled. If the interval to 
be cancelled is part of a periodic group, the entire time period 
is cancelled. 


After executing SVC2 code 23, the CC is set to the possible 
conditions following. 


Condition Code: 

i G | H 

H 

i Normal termination 
§ 

! 


No previous interval request exists that 
a a aa ag Cal matches the parameter provided 
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| Svc2 | 


3.23 SVC2 CODE 24: SET ACCOUNTING INFORMATION 


SVC2 code 24 stores eight bytes of user-supplied information in 
the ATF task completion or data overflow account records of the 
ATF. This is accomplished through the SVC2 code 24 parameter 
block shown in Figure 3-36. 


a RN eS NS SY Sy NY SS Se SS em et et eS ee Gee ae Sem ne me ere Se ne Re me ne oe ee NS SE Cue See ny Re EN Se mt 


|0(0) {1(1) }2(2) | 
Reserved Code Reserved 
| | | | 
Ga cle ay Gace a a i | 
14(4) 
! ! 
! ! 
ieee mierda ae User-supplied information == ~~~----------- 
18(8) | 
| | 
| | 

svc 2,parblk 

ALIGN 4 

parblk DB 0,24 
DC H'O' 
DC D'user-supplied information' 


Figure 3-36 SVC2 Code 24 Parameter Block Format and Coding 


This parameter block is 12 bytes long, fullword boundary-aligned, 
and does not have to be in a task-writable segment. A general 
description of each field in the parameter block follows. 
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Fields: 
Reserved 
Code 
Reserved 
User-supplied 


information 


If more than one 


is a l-byte field that must contain a 0 to 
indicate no options for this call. 


is a 1l-byte field that must contain the 
decimal number 24 to indicate SVC2 code 24. 


is a reserved 2-byte field that must’ contain 
zeros. 


is an 8-byte field that must contain the 
user-supplied information to be stored in the 
ATF task completion or data overflow account 
records. 


SVC2 code 24 is executed by a task, the 


user-supplied information in the last SVC2 code 24 executed is 


stored in the ATF. 
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The CC is always set to 0. 
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3.24 SVC2 CODE 25: FETCH ACCOUNTING INFORMATION 

SVC2 code 25 fetches task accounting information and stores it 
into a user-specified fixed or variable buffer. The accounting 
information accessed is: 

e User CPU time 

@ Operating system CPU time 

@ APU execution time 

e Wait time 

@ Roll time 


This is accomplished through the SVC2 code 25 parameter block 
shown in Figure 3-37. 


10(0) p1(1) 12(2) 13(3) 
H Option Code { Buffer User | 
H { {| length { register t 
svc 2,parblk 
ALIGN 4 
parblk DB ‘option' 
DB 25 
DB ‘puffer length' 
DB user register 


Figure 3-37 SVC2 Code 25 Parameter Block Format and Coding 


This parameter block is four bytes long, fullword 
boundary-aligned, and does not have to be in a task-writable 
segment. A general description of each field in the parameter 


block follows. 
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Fields: 


Option 


Code 


Buffer length 


User register 


—— ee ae Sere en Oe Se OD eS ee ee a Se 


0 anette Gn ame A HD CD Is OE oie em mem eee 


ee eee UR Sere Ne MD Se eae Som etm came mes eeees Mes ef mS GE ORS OND OES ES me ieee me Miney Ge owe EE ON OR OA: ES ST SE ES ST oe ee on ee Oe Se RS Se GE Ge Ee 


is a l-byte field that must contain a number 
specifying one of the following options: 


® Option 0 means that the fixed-size user 
buffer is specified. 


® Option 1 means that the variable-size user 
buffer is specified. 


is a l-byte field that must contain the 
decimal number 25 to indicate SVC2 code 25. 


is a l-byte field that specifies the length of 
the buffer from 24 to 256 bytes for option 1. 
Option O ignores this field. 


is a 1l-byte field that must contain a 
user-specified number of the register that 
contains the starting address of the area to 
receive the accounting information. This area 
is 16-bytes long, fullword boundary-aligned 
and must be located in a task-writable 
segment, as shown in Figure 3-38. The CC is 
always set to 0. 


ce cme ees te ee ee me ee ee a See we ores eee nee ee A rms nee meme mere em es me seme ee ee te Cee cme Oe eee ee ees ee ee ee 
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oO 
e 
oe 
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j- 
3 
o 
-_—_-_ 
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Figure 3-38 Fixed-Size User Buffer Receiving Accounting 
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Information 
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For option 1, the buffer must be a minimum of 23 bytes long; its 
contents, upon execution of the SVC, are shown in Figure 3-39. 


oe ane ee eee ae ee Se ee SE ee ce OE ee oe ce ee eee ee ee ee es Se Se ee me SE EP EP aS EN ae ne ce Se ome Ge eee a ee ee ee ee ee ee ee ee ee ee 


10(0) {1(1) 12(2) 13(3) 
{ Size of H Buffer H Reserved H Reserved | 
buffer used H 
(aes Sea rer Hae eee Sr Sate a een ee a eee 
14(4) 
{ User CPU time (100ns) i 
‘| t 
ee ec a ne ern ee eet | 
i8(8) 
Operating System CPU time (100us) 
i i 
ieee ee eee eae eee eae Ee Cee | 
112(C) ! 
1 Wait time (100ns) | 
1 { 
IO gees cect a | 
1 16( 10) t 
Roll time (10s) { 

‘ 

ean eee es ag Ph ee aie tet se laes : 


ho 
Oo 
-or-~ 
re 
— 
JZ 


em OS ED A ES ON TF ED BO er RD RS SS OS US SE le ED GS DS Rm ee DN EE Re AD WEED foe SO SR NKR GR OD Oe SD a a ee ED eee et 


Available for future 
expansion of accounting 


Slane led nell ace cee eee ee De re ee ee a oe ee ee ee ee ee a 


Figure 3-39 


For option 


1, 


Variable-Size User Buffer Receiving Accounting 
Information 


the CC is set to 0 if the request is successful. 


The V flag is set if the buffer is smaller than required. 
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3.25 SVC2 CODE 26: FETCH DEVICE NAME 
SVC2 code 26 searches for a user-supplied volume name in the VMT 
and returns the name of the device on which that volume is 


mounted. The format for the SVC2 code 26 parameter block is 
shown in Figure 3-40. 


Cl a ee Ere ee he ee eee on oa en ee ee ene enn ee 


| i ] ! 
t ( 1 t 
\ Reserved | Code H User | User 
i ( i] t 
i t { ! 


SVC 2,parblk 


parblk ALIGN 4 


DB 0,26 
DB user register number 1 
DB user register number 2 


Figure 3-40 SVC2 Code 26 Parameter Block Format and Coding 


This parameter block is four bytes long, fullword 
boundary-aligned, and does not have to be in a task-writable 
segment. The fields are described as follows. 


Fields: 
Reserved is a l-byte field that must contain a value of 
0 to indicate no options for this call. 
Code is a l-byte field that must contain the 
decimal value 26 to indicate SVC2 code 26. 
User is a 1-byte field that must contain a 
register 1 user-specified register number. The specified 


register contains a pointer to a fullword 
containing a 4-character volume name. 


48-038 FOO RO2 3-143 


User 


register 2 


is a 1l-byte field that must contain a 
user-specified register number. The specified 
register contains the address of the area 
receiving the device name. This area is four 
bytes long, fullword boundary-aligned and must 
be located in a task-writable segment. 


NOTE 


User registers 1 and 2 can specify 
the same register number. 


Possible CCs occurring after SVC2 code 26 execution follow: 


Condition Code: 


{ Normal termination 
| Specified volume off-line; 


Se cal elects aie ice no fetch occurred 


° ab B . 


ALIGN 


FTCHDEVN DB 
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DB 
DB 


R1l,MTMVOLN 
R2,MTMDEVN 
2,F TCHDEVN 
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3.26 SVC2 CODE 27: MEMORY MANAGEMENT 


SVC2 code 27 allows a task to access and modify entries (except 
shared ones) within the PST in its TCB. This SVC can only be 
called by tasks running on MAT machines. It is used by the 
virtual task manager (VTM) support routines. The format for the 
SVC2 code 27 parameter block is shown in Figure 3-41. 


Ca ee ee ee ce Ae tae A el eee tee ae ee ce Re ee Rone Rene he ee he he ee Re oe no eo en nee ead 


10(0) 1L¢(1) 12(2) User '3(3) User H 
Option Code | register l {| register 2 |; 
} (SV227.0P) {| (SV227.CD) {| (SV227.R1) {| (SV227.R2) | 
(Getieeaanpee<uanine uae canines paauiecsems ca sac Gn rerE aono ! 
14(4) 


{ A (destination buffer) 
(SV227.BF) 


een teenie diene Ticanciies tise Mie ee Ee Te Nene nee rere ieee Re ie A De Te ee ee ed 


svc 2,parblk 


ALIGN 4 
parblk DB option,27,regl,reg2 
DAC  BUFFADR 


Figure 3-41 SVC2 Code 27 Parameter Block Format and Coding 


This parameter block is eight bytes long, fullword 
boundary-aligned and located in a task-writable segment. A 
general description of the parameter block follows. 
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Fields: 


Option 
(SV227.0OP) 


Code 
(SV227.CD) 


User 
register 1 
(SV227.R1) 


User 
register 2 
(SV227.R2) 


(destination 
buffer) 
(SV227.BF ) 
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is a l-byte field that contains a decimal 
number specifying one of the following option 
codes: 


e O (SV227.0) indicates the first byte of 
each PST entry, starting at PSTE 0O and 
ending with the last private segment table 
entry (PSTE) of the task's impure segment 
(PSTE indicated by TCB.CTOP), is moved 
sequentially to a byte buffer specified 
by the S$V227.BF field. After byte is 
is moved, the reference (bit 0) of each 
PSTE is reset. 


e 1 (8V227.1) indicates that bits 15 to 31 of 
PSTE 0 are added to the user register 
specified by the SV227.R1 field. The 
result of the addition is stored in the 
PSTE identified by the number contained in 
the register specified by the SV227.R2 
field. 


e 2 (SV227.2) indicates the value in user 
register 1 is stored in TCB.UTOP and the 
value in user register 2 is stored in 
TCB.CTOP. 


is a l-byte field that contains the decimal 
number 27 indicating SVC2 code 27. 


is a l-byte field that contains a 
user-specified register number. If option 0 
is specified, this field is unused but must be 
reserved. 


is a 1l1-byte field that contains a 
user-specified register number. If option 0 
is specified, this field is unused but must be 
reserved. 


is a 4-byte field that contains the address of 
the first byte of a user-specified buffer to 
which the entries inthe PST are copied. 
This buffer should be located in a 
task-writable writable segment. This field is 
omitted for options 1 and 2. 
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SVC2 code 27 sets the 


Condition Code: 


~ oOo COO 
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CC field in the PSW as follows. 


SVC2 code 27 completed. No errors. 

Size of PSTE exceeds task allocation of 
memory. Entry not stored in PST. 

Illegal PSTE number. 

Shared bit set in PSTE. This entry cannot 
be modified. 

Value of UTOP is greater than value of 
CTOP. 
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3.27 SVC2 CODE 29: UNPACK FILE DESCRIPTOR 
SVC2 code 29 converts a packed fd from the file directory or an 


SVC7 parameter block to its unpacked format. The format for the 
SVC2 code 29 parameter block is shown in Figure 3-42. 


10(0) 11(1) 12(2) 13(3) | 
H Option | Code | Source {| Destination | 
| (UPFD.OPT) {| (UPFD.COD) | register {| register | 
1 | | (UPFD.SRC) {| (UPFD.DST) | 
 iaelaesteeattaeetaetenetonoetaeteetatentaetetenteatetesteateetetentestontentententantentententestententeetentantententestereatenton ee ee ee ee oe ee me me ee wee ee | 
14(4) 
Source pointer for option X'Ol' | 
(UPFD.SAD) | 
Leer es aye ee ee a ee Pe ee ee Se eee 
18(8) | 
Destination pointer for option X'Ol1' | 
(UPFD.DAD) ; | 

SVC 2,parblk 

ALIGN 4 

parblk DB option, 29 
DB source register 
DB destination register 


DAC A(packed fd) 
DAC BUFFADR 


Figure 3-42 SVC2 Code 29 Parameter Block Format and Coding 


This parameter block is 12 bytes long, fullword boundary-aligned 
and located in a task-writable segment. A general description of 
each field on the parameter block follows. 
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Fields: 


Option 
(UPFD.OPT) 
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is a l-byte field that contains a hexadecimal 


-number indicating one or more of the following 


SVC2 code 29 option codes: 


X'80' (UPFO.NNN) forces an account number 
(nnn) into the unpacked fd even if the file 
was allocated without account privileges. 


X'40' (UPFO.PGS) forces a /P, /G or /S 
account designation into the unpacked fa 
even if the file was allocated with account 
privileges. If the account number in the 
packed fd cannot be converted to a P, G or 
S file class, P is returned to the unpacked 
fd and the G bit of the CC is set. 


NOTE 


If neither xX'80' nor xX'40' is 
specified, the fa is packed 
according to the account 
privileges in effect when the file 
was allocated. 


X'20' (UPFO.NOV) unpacks the fd in the file 
directory entry specified in the UPFD.SAD 
field. When unpacked, the fd does not 
include a volume name. 


NOTE 


If X'20' is not specified, SVC2 
code 29 unpacks the fd contained 
in the SVC7 parameter block whose 
address is specified by the 
UPFD.SRC or UPFD.SAD field. When 
unpacked, the fd includes a volume 
name. 


X'10' (UPFO.WID) indicates the unpacked fd 
includes any blanks that exist in the 
packed fd. If option xX'10' is not 
specified, all blanks are suppressed. 


X'08' (UPFO.BLA) indicates the unpacked fda 
is formatted with blanks. If X'08' is not 
specified, the unpacked fd is formatted in 
the standard unpacked fd format including 
a colon (:), period (.) and slash (/). 
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Code 
(UPFD.COD) 


Source 
register 
(UPFD.SRC) 


Destination 
register 
(UPFD.DST) 


Source 


pointer for > 


option X'QL' 
(UPFD.SAD) 


Destination 
pointer for 
option X'OlL' 
(UPFD.DAD) 
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e x'dl' 


(UPFO.ADR) indicates the source 
addressed of the packed fd is specified by 
the UPFD.SAD field of the SVC2 code 29 
parameter block. The unpacked fd is to be 
stored in the address location specified by 
the UPFD.DAD field of the parameter block. 


NOTE 


If xX'Ol' is not specified, the 
source and destination addresses 
are to be found in the registers 
specified by the UPFD.SRC and 
UPFD.DST fields, respectively. 


is a l-byte field that contains the decimal 


number 29 indicating SVC2 code 29. 


is a l-byte field that specifies the number of 
the register that contains the address of the 
file directory entry or SVC7 parameter block 
that contains the source of the packed fd. 


is a l-byte field that specifies the number of 
the register that contains the address ofa 
24-byte buffer in a task-writable segment 
where the unpacked fd is to be stored. 


NOTE 


If option X'OL' has been 
specified, the source register and 
destination register fields must 
be filled with zeros. 


is a 4-byte field that contains the address of 
the file directory entry or SVC7 parameter 
block that contains the source of the packed 
fd. This field is used only if option x'‘'Ol' 
has been specified. 


is a 4-byte field that specifies the address 
of a 24-byte buffer in a task-writable segment 
where the unpacked fd is to be stored. This 
field is used only if option X'Ol1' has’ been 
specified. 


The following examples demonstrate the use of SVC2 code 29. 
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Example 1: 


SVC229 PROG SVC2,29 EXAMPLE - UNPACK FD 
SVC 2,UFD UNPACK FD 
SVC 2, PAUSE 


ALIGN 4 
PAUSE DB 0,1,0,0 PAUSE 
UFD DB X'AlL',29,0,0 NNN, FD, :./, SQUEZ, ADDR 
DAC SOURCE PACK FD INPUT 
DAC DEST UNPACK FD OUTPUT 
SOURCE DB C'TEST cSs',71 INPUT PACKED FD 
DEST DS 24 OUTPUT UNPACKED FD 
END 
Example 2: 


SVC229A PROG SVC2,29 EXAMPLE - UNPACKED FD 


NLSTM 
$SVC7 
LA 1,SVC7PBLK ADDRESS OF SOURCE 
LA 2,DEST ADDRESS OF DESTINATION 
svc 2,UFD UNPACK FD 
SVC 2,PAUSE 
ALIGN 4 
PAUSE DB 0,1,0,0 PAUSE 
UFD DB X'58',29,1,2 PGS, SVC7, BLANKS, BLANKS, REG 
DAC 0 
DAC 0 
SVC7PBLK DS svc7. INPUT PACKED FD 
ORG SVC7PBLK+SVC7.VOL 
Dc C'MTM ' 
Dc C'TEST ' 
DB c'css' 
DB c'G! 
DEST DS 24 OUTPUT UNPACKED FD 
END 
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4.1 INTRODUCTION 


CHAPTER 4 


END OF TASK SUPERVISOR CALL 3 (SVC3) 


The SVC3 instruction terminates task execution. 


4.2 SVC3: END OF TASK 


The following is an example of an SVC3 instruction. 


Format: 


SVC 3,n 


Fields: 


svc 
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is the mnemonic used as an operation code 
specifying a supervisor call. 


is a decimal number indicating it is SVC3. 


is a decimal number ranging from 0 to 255 used 
as the end of task code when the task 
terminates. If this number is greater than 
255, it is truncated to eight bits. End of 
task codes greater than 255 are reserved for 
system use. The end of task code can be used 
in subsequent command substitution system 
(CSS) conditional testing. The following 
standard end of task codes are used: 


e O indicates normal termination. 


e 255 indicates termination caused by 
cancellation. 


@e 1000 indicates termination caused by task 
queue overflow on expiration of time 
interval. 


@e 1100 indicates a mapping error in an impure 
‘segment during roll-in. 


@ 1101 indicates a mapping error in a _ pure 
segment during roll-in. 


@e 1102 indicates a pure segment was not found 
during roll-in. 


e 1105 indicates an input/output (I/0) error 
on a roll file for an impure segment. 


e 1106 indicates an I/O error on a roll file 
for a pure segment. 


@ 1200 indicates termination caused by the 
expiration of a central processing unit 
(CPU) time limit. 


e 1210 indicates termination caused by the 
expiration of an I/O transfer limit. 


In addition, the end of task code can be stored in a _ register. 
For example, to generate a code of 4, use the following sequence: 


LHI R8,4 
svc 3,0(R8) 


If I/O is in progress when an SVC3 is executed, write operations 
continue until completed and then terminate normally; read 
Operations terminate immediately. 


For each logical unit (lu), read operations and SVC15 operations 
are halted as if an SVCl halt I/O were issued. In addition, each 
open lu is checkpointed (for a resident task) or closed (for a 
nonresident task) as if the corresponding SVC7 had been issued. 


The SVC3 may be intercepted by the task's monitor. Normally the 
operating system generates messages for foreground and background 
tasks and the multi-terminal monitor (MTM) generates messages for 
terminal and batch jobs. The system messages contain the end of 
task code and accounting information for the task. 


For more information on using end of task codes in CSS, see the 
OS/32 Operator Reference Manual. 
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CHAPTER 5 
FETCH OVERLAY SUPERVISOR CALL 5 (SVC5) 


5.1 INTRODUCTION 

SVC5 permits user-controlled loading of overlays generated by 
Link or TET. Loading of overlays is accomplished through the 
SVC5 parameter block in Figure 5-1. The SVC5 parameter block is 
12 bytes long, fullword boundary-aligned and must be ina 
task-writable segment. 


5.2 SVC5: FETCH OVERLAY 


Figure 5-1 is an example of an SVC5 fetch overlay. 


ee ee me mk Cee er ate eee me me en come ae att ee ey ee ee Se Sm Se teres ee ome ces ee ae ee ee ee ee me nem ee em ee eee ee ee ee es i ee ee ee re ee ee ee 


10(0) | 
! ! 
I ( 
1 Overlay name 
SSeS (SVCSeID): ——— : ier Rremqee 
14(4) | 
| | 
| 
| cee ee ces et ee ee kes ce me rt mh ene ce heme ems cs nee nee mee he ce me es ce mee me ee se tres ee te ne cam te tbe eee ems SEED Sw ets te Mat ee tie oe t 
18(8) 19(9) {10(A) Logical unit (lu) { 
{| Error status |} Options | assigned to overlay file | 
i} (SVC5.STA) {| (SVC5.OPT) | (SVC5 .LU) 

SVC 5,parblk 

ALIGN 4 

parblk DC C'8 character overlay name' 

DS 1 

DB X'option' 

DC H'lu' 


Figure 5-1 SVC5 Parameter Block Format and Coding 
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Fields: 


Overlay name 
(SVC5.ID) 


Error status 
(SVC5.STA) 


Options 
(SVC5.OPT) 


is an 8-byte field specifying the name of the 
overlay to be loaded. If the overlay name 
requires less than eight characters, the data 
in this field must be left-justified with 
trailing spaces. 


For overlays generated by TET, the overlay 
name field is matched against the overlay name 
in the loader information block (LIB) of the 
overlay file. For overlays generated by Link, 
this field is matched against the overlay name 
specified in the OVERLAY command. (From the 
overlay descriptor table (ODT) of the task 
image file.) If the overlay name is_ found, 
loading of the overlay proceeds as if an 
automatic overlay load occurred. 


is a l-byte field that receives the 
appropriate error code when an error occurs 


during the execution of SVC5. The status 
returned is one of the following: 


e xX'Ooo' indicates over lay loaded 
successfully. 

@e xX'10' indicates load failed. 

e X'20' indicates a mismatch on overlay name. 

e xX'40' indicates the overlay would not fit 


in allocated memory. This error code 
applies to overlays generated by TET only. 


is a l-byte field that must contain one of the 
following options: 


@ Option X'O1' indicates load from lu without 
positioning. | 

@ Option X'04' indicates load from lu after 
rewind. 


The option byte is not required for overlays 
generated by Link and is ignored. 
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lu assigned is a 2-byte field containing the device to 


to overlay which the overlay file must be assigned and 
file must be positioned to the first byte of the. 
(SVC5.LU) LIB for the overlay generated by TET. This 


field is not required for overlays generated 
by Link and is ignored. 


The calling task is placed in a wait state until the overlay is 
loaded. If the overlay is successfully loaded, the calling 
program can branch and link to the overlay. 


Certain messages might be generated as a result of loading 
overlays created by Link. These messages are discussed in the 
OS/32 Link Reference Manual. 


Example: 
SVC 5,parblk 
ALIGN 4 
parblk DC C'MARIANNE' 
DB 0 Initialize status to 0 
DB 1 Load without positioning 
DC HY”:2* Overlay assigned to lu2 
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CHAPTER 6 
INTERTASK COMMUNICATIONS SUPERVISOR CALL 6 (SVC6) 


6.1 INTRODUCTION 


SVC6 provides a task with the ability to communicate with and 
control another task. The task that issues an SVC6 is known as 
the calling task. An SVC6 can be directed to any task within the 
calling task's execution environment, including the calling task 
itself. The task to which SVC6 is directed is called the 
directed task. 


Before a calling task can issue an SVC6, that task must be linked 
with one of the following task options: 


@ COMMUNICATE - This option allows a calling task to perform 
SVC6 intertask communications functions (see Section 6.2.1). 


@e CONTROL - This option allows a calling task to perform SVC6 
intertask control functions (see Section 6.2.1). 


@ NOCOM - This option prevents the calling task from executing 
SVC6 communications functions. 


@e NOCON - This option prevents the calling task from executing 
SVC6 control functions. 


~@ SVCCONTINUE - This option causes an SVC6 executed in a 
background environment to be ignored. 


In an O0OS/32 real-time environment, only foreground tasks’ can 
issue an SVC6. If a background task attempts to issue this call, 
the operating system treats the call as an illegal call or NOP, 
depending on the SVCPAUSE task option in effect. See the 0S/32 
Link Reference Manual for more information on the task options 
that apply to SVC6. 


NOTE 


SVCc6 cannot be executed in a 
multi-terminal monitor (MTM) environment 
unless specified as an MT option at 
system generation (sysgen). The use of 
Svc6 in an MTM environment can also be 
restricted on an account basis via MITM 
account privileges. See the MTM System 
Planning and Operator Reference Manual 
for more information. 
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| SVvC6 { 
6.2 SVvC6: INTERTASK COMMUNICATIONS 


Communication and control between tasks are accomplished through 
the SVC6 parameter block shown in Figure 6-1. 


10(0) 
! 
i] 
' Name of task { 
[ower cee cern ne receiving SVC6 = ~ rrr rrr errr nmr nrn | 
14(4) (SVC6.1D) | 
{ ‘ 
Ra haa a aaa ial ag aa al a | 
18(8) i 
! Function code i 
i (SVC6.FUN) H 
SB ls «cand aka: Sham’ ees Mines nas sabes Saga WS Sas“ ts WE ei Sa cs eGo Ut es” ssa el sis ee <n a a Sel Sl scl Sel i iil ! 
Mie ee ge Fe ee ee POTS Rey 4 oe oe Sg es i) 
112(C) 114(E) { 
| Wait status { Error status H 
{ (SVC6.TST) { (SVC6.STA) ' 
ww ee ee we we wn a a a ee ee we a a a se ee en wa a ew wee wee we = = H 
116(10) t17(11) 118(12) 119(13) { 
| logical unit | Change H Current H Logical 
{| (lu) to load | priority i priority i processing | 
{| task I (SVC6.PRI) H (SVC6.RPI) i unit (LPU) H 
{ (SVC6.LU) H i { (SVC6 .LPU) i 
lets Sr Se Stor rte See Rate ee SSeS Sasa ces I 
{20(14) | 
| Starting address of'directed task H 
| (SVC6.SAD) t 
eee Re ee ee ee ee eR ee eee ee ae ee ee ee ee oe ee ewe H 
124(18) 125(19) ' 
{1 Increment of | Count ; i 
{ time | (SVC6.CNT) I 
t (SVC6.TIM) t H 
[ees eine PSSST S apr Sates Ss Bae ae See ee Rear SSeS eas I 
{28(1C) 
{ Address of load image file descriptor (fd) or device } 
\ mnemonic i 
H (SVC6.DMN) i 
SD sce a esa ae nnd dt eS" ean Sec ye abt ees Sich a eases Ss SS es ly ett hh‘ “Sa Sats en eas "an ‘gies si a “aed lag Msp" es Sy { 
ee ne ae ge ee te BRT te ee Ne NE ne Se nee ee Sn gc ee { 
132(20) {33(21) { 
| Reserved H Task queue parameter t 
{ (SVC6. PAR) 
[SSeS ses rcSe Sesh e esses SS Seer cs tase Seas esas sSese SS H 
136(24) ' 
{ Address of message buffer or address of start options i 
(SVC6.MSG) (SVC6.SOP) i 
[RSS See Sas Soro SPSS SS ese roast a esters sss See i 
140(28) { 
{ Segment size increment i 
{ (SVC6 .SEG) \ 
[ie Seas 2S Aer A Ses sea eee Seer ree Saar esi Sesser ess i 
144(2C) 145(2D) 146(2E) | 
{ Calling lu {| Directed lu |} Extended load options H 
{ (SVC6.CLU) | (SVC6.DLU) | (SVC6.ELO) { 

svc 6,parblk 

ALIGN 4 

parblk Dc C'8-byte name of task receiving SVC6' 

Dc Y'function code' 

DS 2 bytes for wait status 

DS 2 bytes for error status 

DB l byte for lu to load task 

DB l byte for change priority 

DS 1 byte for current priority 

DB 1 byte for LPU 


Dc A(start address of directed task) 


pc Y'increment of timetcount' 

pc C'4-byte device mnemonic' or A(fd) 
DC Y'task queue parameter' 

DC A(message buffer or start options) 
DC Y¥'segment size increment’ 

DB 1 byte for calling lu number 

DB l byte for directed lu number 

DS 2 bytes for extended load options 


Figure 6-1 SVC6 Parameter Block Format and Coding 
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This parameter block must be 48 bytes long, fullwora 
boundary-aligned and located in a task-writable segment. For a 
detailed description of the functions of each field in the 
parameter block, see the appropriate section in this chapter. A 
brief description of each field in the parameter block follows. 


Fields: 


Name of task is an 8-byte field that contains the task 


receiving name to which SVC6' is directed. If SVC6 is 
SVC6 a self-directed call, this field is not 
(SVC6.ID) required. The name must consist of one to 
eight alphanumeric characters with the first 
character always alphabetic. It is 
left-justified in the field with spaces. 
Function is a 4-byte field that contains the 
code hexadecimal number indicating the function to 
(SVC6 .FUN) be performed. 
Wait status is a 2-byte field that receives the 
(SVC6.TST) hexadecimal value of bits 16 through 31 of the 


Girected task's wait status fullword when a 
SVC6 is executed. If the calling task wants 
to check the wait status of the directed task 
at any time, an SVC6 can be issued with the 


function code set to ¥'80000000' Or 

¥'cooooo0o0'. 
Error status is a 2-byte field that receives the 
(SVC6.STA) appropriate error code when an error. occurs 
during execution of the SVC6. If no error 


occurs, a value of O is stored in this field. 


lu to load is al-byte field used only when a_ load 

task operation is requested. This field specifies 

(SVC6.LU) the logical unit (lu) currently assigned to 
the directed task that is to be loaded. 

Change is a l-byte field used only when a change 

priority priority operation is requested. This field 

(SVC6.PRI) must contain a user-specified hexadecimal 
number indicating the new priority to which 
the task is to be changed. The hexadecimal 
number must have a decimal value ranging from 
10 to 249. . 
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Current 
priority 
(SVC6.RPI) 


Logical 

processing 
unit (LPU) 
(SVC6 .LPU) 


Starting 
address of 
directed 
task 
(SVC6.SAD) 


Increment of 
time 
(SVC6.TIM) 


Count 
(SVC6.CNT) 


Address of 
load image fd 
or 

device 
mnemonic 
(SVC6.DMN) 


is a l-byte priority field that receives a 
hexadecimal number indicating the priority 
at which the task is executing when an SVC6 is 
executed. If the calling task wants to check 
the current priority of the directed task at 
any time, an SVC6 can be issued with bits 0 
and 1 of the function code set to 10 or 1l, 
and the remaining bits set to 0. 


is a l-byte field used only when an LPU 
assignment operation is requested. It 
contains a user-specified hexadecimal number 
indicating the LPU assigned to the task 
(O0...max LPU). 


is a 4-byte field used only when a start 
operation is requested. This field must. 
contain a user-specified hexadecimal number 
indicating the address where the directed 
task is to start execution. 


is a l-byte field used in conjunction with the 
count field only when the delay-start 
operation is requested. This field must 
contain a user-specified hexadecimal number 
indicating how the time is to be calculated. 
These hexadecimal numbers are: 


@e xX'OO' indicates seconds from midnight (time 
of day). 


e X'10' indicates milliseconds from the time 
this call is executed (interval timing). 


is a 3-byte field used in conjunction with the 
increment-time field only when a delay-start 
operation is requested. This field must 
contain a user-specified decimal number 
indicating how many seconds or milliseconds 
must elapse before the directed task starts 
execution. 


is a 4-byte field that contains a 
user-specified device mnemonic of a trap 
generating device when the connect, 
thaw, sint, freeze or unconnect operations are 
requested. If a task is to be loaded with bit 
3 (load and proceed) of the extended load 
option field set, this field should contain 
the address of the file descriptor (fd) of the 
file containing the task to be loaded. 
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Reserved 


Task queue 
parameter 
(SVC6. PAR) 


Address of 
message 
buffer 
(SVC6.MSG) 

or 

address of 
start options 
(SVC6.SOP) 


Segment size 
increment 
(SVC6 .SEG) 


Calling lu 
(SVC6.CLU) 


Directed lu 
(SVC6 .DLU) 


Extended 
load options 
(SVC6.ELO) 


is a reserved l-byte field that must contain 
a 0. 


is a 3-byte field used only when the add to 
task queue or connect to trap generating 
device operations are requested. This field 
must contain the user-specified parameter that 
is to be added to the task queue of the 
directed task. 


is a 4-byte field used only when aé_e send 
message operation or start operation is 
requested. For the send message operation, 
this field must contain a _ user-specified 
hexadecimal number indicating the address of 
the buffer containing the message to be sent 
to the directed task. For the start operation, 
this field must contain the address of the 
start options to be included at run-time. 


is a 4-byte field used only when a load 
operation is requested and must contain the 
user-specified hexadecimal number indicating 
the number of bytes used to expand the task's 
allocated memory. 


is a 1l-byte field that must contain the 
user-specified hexadecimal number representing 
the logical unit of the calling task. 


is a l-byte field that must contain the 
user-specified hexadecimal number representing 


the logical unit of the directed task. 


is a 2-byte field used only when the extended 
load options are requested. This field must 
contain a user-specified hexadecimal number 
indicating one or more of the options listed 
in Table 6-3. 


6.2.1 Function Code (SVC6.FUN) 


SVC6.FUN has 21 


functions for intertask communications’ and 


control. These functions are listed in Table 6-1. 
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TABLE 6-1 SVC6.FUN FUNCTIONS 


COMMUN I CATION 
FUNCTIONS 


Send data 
Send message 
Add to task queue 


} Direction 

| End task 

| Load task 

| Resident task 
{| Suspend . 
{| Change priority 
} Send lu 

' Receive lu 

} Connect 

i Thaw 

| Sint 


i CONTROL, FUNCTIONS 


Freeze 
Unconnect 
Assign LPU 
Transfer to LPU 
Transfer to CPU 
Release 
Nonresident 
Rollable 
Nonrollable 
Start 


These functions are specified by setting the appropriate bits in 
the function code field shown in Figure 6-2. Each bit setting 
and its corresponding function are listed in Table 6-2. 
Reserved 
'C;HisS | Si MiQiPi Bi Vy 
7 8 9 10 11 12 13 14 #15 
Reserved 
;Ooj;T {| I {| F {| U {| AP] TL} TC} R | Nf Y ] Z | 
Bits: 
16 17 #18 #19 #20 21 22 23 #24 #=%25 26 27 28 29 31 
Figure 6-2 SVC6 Function Code Field 
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TABLE 6-2 DESCRIPTION OF FUNCTION CODE FIELD FOR SVC6 CALLS 


ee See Sn ee GY ee Ge GD Gk Ge Come Gems: Geet Se Si me Re Gee Gee mee SES Gown ene mene eee Gee ome cone Swen meee mee me mer ces ee mt ee me i oe ee me OO wes Ge ee me ee ee ee ee ee ee ee ee 


H BIT { FUNCTIONS AND } H 
{ POSITIONS | MASK NAMES H MEAN ING { BIT SETTINGS 
i BEM SEB E BSE SEES SSE BSI SS SVS BIS eKCSSBS SESE EBSSECSCBESAS ES Sees swe AAs: 
{ O (D) | Direction i The task to | 0O = illegal 
} 1 | (SFUN.DOM=10) {| which SVC6 is ;} O1 = illegal 
H | (SFUN.DSM=11) | directed {| 10 = other task 
' 11 = self-directed 
| a os i cs a me "es ee ui eh “ome Sch“ “ns as cv wn “ts em Gan cosa a” esses" evs Stadia limo mew ek ei is as hae cc te ene pes a 
H 2 (E) | End task | End or term- | OO = no function 
! |} (SFUN.ECM=01) | inate task H requested 
{ | (SFUN.EDM=10 {| execution. { Ol = cancel 
| } or =11) | {| 10 = delete direc- 
H | | H ted task 
| H H } ll = delete direc- 
\ | | H ted task 
| a i a a a a a a a a a a cts ee smn ci ch a, ne emesis Se a Ge es os Se Sem fa 
4 i N/A {| Reserved | OO = reserved 
5 
| tes css mee ale a an et a ma, yes cl scm oc Tas sav “seca cn abo arma uch ata Su eos “cl is et teres ns oa ahi 
6 (L) Load task Load the OO = no function 
7 (C) (SFUN.LM=10 directed task. requested 
SFUN .LXM=01) O1 = illegal 
10 = load task 
11 = load task 


extended load 


! 

' 

| 

| (10) with 
| 

' 

H options (01) 
t 

, 

H 

| 


8 (H) Resident task Make the 0 = no function 
(SFUN.HM) directed task requested 
. resident 1 = make task 
in memory. resident 
{ 9 (S) | Suspend i} Put the direc- {| O = no function 
H | (SFUN.SM) | ted task into | requested 
i | await state. {| 1 = put task into 
H | H { wait state 
{ a a a a a a i a sm ema ea a es aw ln mn ms es ee Se ee 
;} 10 (SD) {| Send data | The calling {| O = no function 
{| (SFUN.DM) | task sends a requested 
H | |} variable | 1d = send message 
H H | length message | 
H i i} to the direc- | 
| i } ted task. H 
(SSS a a Se ae See eS a Sea ener tre 
11 (M) Send message The calling 0 = no function 


- (SFUN.MM) } task sends a H requested 

| 64-byte mes— i tl = send message 
| sage to the 

| Girected task. | 
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TABLE 6-2 DESCRIPTION OF FUNCTION CODE FIELD FOR SVC6 CALLS 
(Continued) 


connected to 
the directed 
task. 


BIT } FUNCTIONS AND |} 
POSITIONS | MASK NAMES | MEAN ING H BIT SETTINGS 
12 (Q) | Add to task } Add parameter {| O = no function 
} queue | to the direc- | requested 
| | (SFUN.QM) | ted task's | 1 = add to task 
H { queue. H queue 
13 (P) {| Change |} Change the | O = no function 
{| priority {| priority of requested 
| (SFUN.PM) | the directed | 1 = change the 
H | task. priority 
14 (B) i Send lu | Calling task's {| O = no function 
| (SFUN.XSM) | lu is assigned {| — requested 
| to the direc- {; 1 = send lu 
| { ted task. H 
15 (V) | Receive lu i; Directed | O = no function 
| (SFUN.XRM) ij task's lu is requested 
{ assigned to ; Ll = receive lu 
} the calling H 
| | task. H 
16 (0) } Connect | A trap genera- {| O = no function 
| (SFUN.OM) ; ting device j requested 
H } is connected i} id = connect 
{ | to the direc- | device to 
i |} ted task. 1 task 
17 (T) | Thaw | Enable inter- {| O = no function 
| (SFUON.TM) | rupts ona H requested 
H | trap genera- i 1 = enable inter- 
H | ting device H rupts 
H } connected to 
| | the directed H 
H |} task. H 
18 (1) | Sint i Simulate } O = no function 
{ (SFUN.IM) | interrupt on H requested 
H | a trap genera- | 1 = simulate 
| ting device interrupt 
| to the direc- | 
|} ted task. H 
19 (F) | Freeze i} Disable inter- {|} O = no function 
| (SFUN.FM) } rupts ona requested 
i | trap genera- i 1 = disable 
H ; ting device { interrupts 
! 1 { 
! | ! 
i 
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TABLE 6-2 DESCRIPTION OF 
(Cont inued ) 


FUNCTION CODE FIELD FOR SVC6 CALLS 


ee ee me See eH ey nen eee SMES Geet Ge ey ce Se em me ie ey ems eae Gee Gwe Gwe Gees meee eee Soe ee mane See ey meee Gove StU Ou em ee cee me me ee ee me me eee ee ee ee ee ee ee ee 


| BIT | FUNCTIONS AND | H 

| POSITIONS {| MASK NAMES H MEAN ING BIT SETTINGS 

H EERE BES SAS SPSL S SSSI SKS eSBs SS STS SSS SST STS SVS TS SIS ST SV SS TS ST SI VTS 
i 20 (U) } Unconnect } Disconnect the } O = no function 

{ | (SFUN.UM) | specified H requested 

H | | trap genera- | 1 = disconnect 

H | | ting device device from 

{ | | from the | task 

H 1 Garected task. |} 

{ ss i ne mh a samosas ce yh nei emi a i man ema mn is ah a ec ey 
| 21 (AP) {| Assign LPU | nastier an LPU {| O = no function 

H | (SFUN.LPM) | to the direc- |} requested 

| H i} ted task. ; 1 = assign LPU 

| i a it's ch a i ce“ cl ‘im samp il cm se Sahat sims “cena cd es nn Sinise “smc “es ee ia a GS es we: il ee nas “cm “a “ce 
|} 22 (TL) i Transfer to | Make the task {| O = no function 

| | LPU | LPU-directed. } 1 = set LPU- 

H | CSEUM: XLM) H | directed 

{ Si ein ch“ rs ‘tm Se, Sy ea mon pt en mies sco ‘Gms Sma cn cam i aw hs een": “nae na 
{| 23 (TC) | Transfer to | Make the task | O = no function 

| | CPU | CPU-directed. | requested 

| {| (SFUN.XCM) H | 1 = reset LPU- 

H | H H directed 

} 24 (R) | Release | Remove the ; O = no function 

i | (SFUN.RM) | GQirected task jj} requested 

H | i from a wait {| 1 = remove task 

H H | state. H from state 

\ Soc ccs eae testa a i a ena cc ce a a eel a a fl ee ee a ties ees oe et Le 
; 25 (N) | Nonresident | Make the { O = no function 

H | (SFUN.NM) | directed task /} requested 

H i | nonresident. i 1 = make task 

| | H H nonresident 

H cee ce cae mae rum cme em aes me ey maa es ee foes ce SOs te mT SnD ee mse un omy Sens ms cs cm Sa nme sem men mh ns rye Sune ch a ee OG es vn cee nS es eee oD ee tem mts OD vem ste ee cms ee Mee ores ee cee 
} 26 (Y) {| Rollable Make the {} O = no function 

} { (SFUN.RLM) i directed task /} requested 

| | {| rollable. ; 1 = make task 

| H | H rollable 

H ca a ist emi ec “mln eos” cen, ea mu‘ es “ec os ahs “ein “cess om “hss cs“) Sass evel ic ee ms SS. S==- SS = 
| 27 (2) { Nonrollable | Make the { O = no function 

{ {| (SFUN.NRM) | directed task jj} requested 

} nonrollable. {| 1 = make task 

{ H { H nonrollable 

| come meets ene ces cee ene meee eth cme, ers ese enue Sa eens teh shes fm veh Sou crm oes mins SD NOMS GE OO OH Cen GED GOD GE GEDA {ewe fame OOS SE Sete Geb Gee cme cis Men Me OS Gane un ae OOF OO See GD One Om ee oe Gene SE See OE om Oe ae ae oe 
i 28 | N/A ! Reserved ' O = reserved 
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TABLE 6-2 DESCRIPTION OF FUNCTION CODE FIELD FOR SVC6 CALLS 


(Continued) 
BIT | FUNCTIONS AND | 
POSITIONS {| MASK NAMES { MEAN ING BIT SETTINGS 

29 | | Start ; Start {| 000 = no function 

30 (A) (SFUN.SIM=010){ execution of requested | 

31 (SFUN.SOM=011)! the directed 001 = illegal 
(SFUN.SDM=100);| task. . 010 = start 
or O11 = start with 


100 = delay start 

101 = delay start 
with start 
option 

110 = delay start 


at a Ren ED re SN OD a ee ce Se Se ee ee es ee ee cee SD OS ee ee oes ee ee ee OD ee Ge Oe em oe ce Eee cee aD om omen aoe ee 


4 1 
| 
{ H H 
| 
| (SFUN.SDM=110) } start option 
! 1 i 
! ! 
H 
H 


6.2.2 Direction (SFUN.DOM, SFUN.DSM) Function 


The direction function identifies the task to be affected by the 
SVC6 call. The name of this task is located in the task name 
field. The required parameter block fields for this function 
are: 


e Task name field (SVC6.ID) 


e Bits 0 and 1 of the function code field (SVC6.FUN) 


If the bit setting equals 10 (SFUN.DOM), the call is directed to 
the task whose name is specified in the task name field. If the 
bit setting equals 11 (SFUN.DSM), the call is self-directed 
(directed to the task initiating the call). A self-directed call 
does not require a name in the task name field. A call can also 
be self-directed by setting the bits to 10 and specifying the 
calling task name in the task name field of the parameter block. 
Other bit settings for bit positions 0 and 1 are illegal and 
cause an error code to be stored into the error status field of 
the parameter block. 


6.2.3 End Task (SFUN.ECM, SFUN.EDM) Function 


The end task function abnormally terminates (cancels) execution 
of the directed task. The required parameter block fields are 
the task name field and bit positions 0, 1, 2 and 3 of the 
function code field. When the bit setting equals 01 (SFUN.ECM) 
and the directed task is resident, these operations occur: 


6-10 48-038 FOO RO2 


e Task execution is cancelled (end of task code = 255). H 
e The task remains in memory. 
@e All of the task's assigned files and devices are checkpointed, 


not closed. 


When the bit setting equals 01 (SFUN.ECM) and the directed task 
is nonresident, these operations occur: 

e Task execution is cancelled (end of task code = 255). | 
e The task is removed from memory. 

@e All of the task's assigned files and devices are closed. 

When the bit setting equals 10 or 11 (SFUN.EDM), these operations 
occur: 

e Task execution is cancelled (end of task code = 255). { 
e The task is made nonresident (if it was resident). H 
e The task is removed from memory. 

e All of the task's assigned files and devices are closed. 

If this call is self-directed, SVC6 is immediately terminated. 
After the call is executed, an end of task code 255 indicating 
abnormal termination is returned to the user. 

6.2.4 Load Task Functions 

The load task function loads the directed task into memory. 
Options are provided for the calling task to wait until the load 

is completed or to continue execution and receive a trap when the 
load is completed. 

When a task is loaded, the operating system reads the loader 
information block (LIB) of the task to see if any needed shared 
segments are already in memory. If they are not in memory, the 
auto loader feature automatically loads them, provided sufficient 
memory exists. See the OS/32 Operator Reference Manual. When 


all shared segments named in the LIB are memory resident, the 
operating system builds linkages to them. 
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6.2.4.1 Load Task (SFUN.LM) Function 


The required parameter block fields for bit setting 10 in bits 6 
and 7 (SFUN.LM) are: 


e Task name field (SVC6.ID) 
e Bits 0O, 1, 6 and 7 of the function code field 


@e lu to load task field (SVC6.LU) 


Before executing this call, the lu specified in the parameter 
block must be assigned to the file or device containing the 
directed task image. This call is processed as a load wait. 


The lu must be positioned to the first byte of the task LIB. 
When this call is executed, the directed task is loaded from the 
specified lu into a memory area large enough to hold the _ task. 
If such an area does not exist and the roll option is specified, 
the directed task is rolled out to a file on the roll volume and 
placed in a wait state. While the directed task is being loaded, 
the calling task is placed in a wait state. When the directed 
task is loaded, its task name becomes the name specified in the 
task name field of the parameter block. The calling task is 
released from the wait state, and the lu is positioned to the 
record following the loaded task. If the same task is to be 
reloaded from other than a direct access file with the same lu 
assigned, the lu must be rewound by using SVCl prior to each 
subsequent load. For direct access files, the load task function 
automatically rewinds the file and initializes the start address 
to zero. 


If the following error conditions occur, SVC6 is rejected, and an 
error code is stored in the error status field of the parameter 
block: 

@ The receiving task is already loaded into memory. 

@e The task name specified in the parameter block is invalid. 


e The call is self-directed. 


@e The system does not have a memory area large enough to hold 
the receiving task and does not support the roll option. 


@ The requested memory size specified in the segment size 
increment field is larger than the total system memory space. 


e The directed task is a background task. (Background tasks can 
be loaded only from the system console. ) 


@ The lu is not positioned to the LIB or the LIB is invalid. 
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6.2.4.2 Load Task with Extended Load Options (SFUN.LXM) Function 


The extended load options can be specified at load time and are 


located in the extended load options field of the parameter block 
(see Figure 6-3). 


Reserved 


{CM {RP {SZ {PR {ET {CT | 


Ee  _ 


0 L 2 3 4 5 6 7 8 15 


Figure 6-3 Extended Load Options Field 


The required parameter block fields for bit setting 11 in bits 6 
and 7 (SFUN.LXM) are: 


@ Task name field (SVC6.ID) 
@e Bits 0, 1, 6 and 7 of the function code field 


@e lu to load task field (SVC6.LU) (required when the load wait 
extended option is specified) 


@ Address of load image fd (SVC6.DMN) (required when load and 
proceed extended option is specified) 


@ Extended load options field (SVC6.ELO) 


@ Segment size increment field (SVC6.SEG) (required only when 
the extended load option SELO.SZM is set). 


When a task is loaded with the SFUN.LXM enabled, any options 
specified in the extended load options field are in effect during 
the loading of the directed task. See Table 6-3 for a list of 
the available options. 


When the extended load and proceed option is requested, the 
calling task continues executing while the directed task is 
loaded. The directed task is loaded from the file indirectly 
specified by the device mnemonic field in the SVC6 parameter 
block. This field should contain the address of the fd of the 
task image file to be loaded. If the roll option had been 
specified when the directed task was link-edited, the private 
image segment of the task is rolled out to disk if sufficient 
memory space is not available. 
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When bit 3 (load and proceed) of the extended load options field 


is not set, execution 
loading of the directed 
operation. After a load 
task is released from 
directed task image file 
the last byte of the 


of the calling task is suspended during 
task. This is called a load wait 
wait operation is completed, the calling 
suspension and the lu assigned to the 
is positioned at the record following 
task image. If the task is again loaded 


from the same lu, an SVCl rewind operation should be performed on 
the task image file prior to that load. 


TABLE 6-3 EXTENDED LOAD OPTIONS FIELD BIT DEFINITIONS 


— yy SE NT cies She Sem Ge ew CES SST moe Seer Se mney sees 


BIT { OPTION AND 
POSITION {| MASK NAME 


O (CM) Intertask 


(SELO .CMM) 


' 
' 
t 
' 
! 
! 
t 
' 
' 
' 
! 
! 
| 
' 
J 
' 
i 
! 
{ 
t 
t 
' 
! 
' 
{ 
fj 
! 
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Subtask 
reporting 
(SELO.RPM) 


2 (SZ) 
increment 
(SELO.SZM) 


communication 


ees ree ee es ee ee ee ee ee es ee ee ee ee oe ee es 


Segment size 


1 MEAN ING 


If bit O0 equals 1, the directed 
task that was loaded into memory 
can execute the SVC6 communica- 
tion functions. 


receiving task issues an SVC6 
communication function, the call 
is rejected, and an error code is 
stored in the error status field 
of the parameter block. 

If bit 1 equals 1, the calling 
task becomes a monitor task and 
the directed task becomes a sub- 
task. This causes the subtask to 
report all status changes during 
execution to the monitor task 
through task traps. 


! 
| 
| 
} If bit O equals O and the loaded 
! 
| 


i 

i 

1 

1 

| If bit 1 equals 0, the directed 

| task is not a subtask. No subtask 
| status changes are reported. 

| If bit 2 equals 1, the size of the 
|} task workspace is increased by 

| adding a user-specified number of 
| bytes. This hexadecimal number 

i must be located in the parameter 

| block segment size increment 

i field. 

1 

J 


If bit 2 equals 0, the workspace 
set by the WORK= parameter of the 
LINK OPTION command is used. 
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TABLE 6-3 EXTENDED LOAD OPTIONS FIELD BIT DEFINITIONS 
(Continued) 


ee eee cm ee Re mE HOS Seem mem mee a (ms my Stem erm emmy GUE Mee reeves Sim comes cies Se meee me cents cme a im cee ce ee eee ee ee ee ee ee ee ee ee ee ee ee ee ee ee 


BIT | OPTION AND H 

POSITION {| MASK NAME 
Load and i If bit 3 equals 1, the calling 
Proceed { task continues executing while 

(SELO.PRM) } the directed task is being loaded 
i from the file specified by the 

| device mnemonic field of the SVC6 
| parameter block. A trap to the 

{} calling task occurs if bit 20 of 

| its task status word (TSW) equals 
i 1 (load and proceed complete). 

i When the trap occurs, the reason 

} code is 7 and the SVC6 parameter 

| block address is added to the 

| task queue. * 
$ 
) 
t 
| 
‘ 
| 


If bit 3 equals 0, the calling 
task is suspended while the direc- 
ted task is loaded from the speci- 
fied lu. This lu must be assigned 
to the file or device from which 
the task is to be loaded. 


Prevent 
executive 
task (e-task) 
or diagnostic 
task (d-task) 
(SELO.ETM) 


If bit 4 equals 1, any directed 
task that is an e-task or d-task 
is not loaded. If the calling 
task issues an SVC6 call to load 
an e-task or d-task with this bit 
set, the call is rejected, and an 
error code is stored in the para- 
meter block error status field. 
If the loading task has bit 4 set 
and the directed task was linked 
with the ACPRIVILEGE, DISC or 
INTERCEPT task option, the task 
will be loaded but these options 
will be disregarded. 

If bit 5 equals 1, the directed 
task that is loaded can execute 
the control functions of SVC6. 


Intertask 
Control 
(SELO.CTM) 


If bit 5 equals O and the directed 
task that is loaded issues an 

SVC6 control function, the call is 
rejected, and an error code is 
stored into the error status field 
of the parameter block. ** 
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TABLE 6-3 EXTENDED LOAD OPTIONS FIELD BIT DEFINITIONS 


(Cont inued ) 
1 BIT i OPTION AND H H 
{| POSITION {| MASK NAME | MEAN ING H 
i} 6 (RL) } Roll { If bit 6 equals 1, the directed H 
H {| (SELO.RLM) i task is forced to be a rollable | 
| to {| task regardless of the roll option | 
{| established by Link. 
| | 7 | 
{| If bit 6 equals 0, the directed 
| task uses the roll option estab- 
{ lished by Link. 
[ee ee es a a ee eee 
7 (AC) Accounting If bit 7 equals 1, the directed 
(SELO.AEM) task that is loaded is given the 


} accounting option. This setting 
| overrides the NOACCOUNT option 

|} established by Link. 
1 
' 


If bit 7 equals 0, the directed 
task uses the accounting option 
established by Link. 


ae Se AD SE aD SE A ee Ge SE oe cs Se ee ee ee ee ee eee es See es ee ee ee re ee ee ee fee ee eee et eee ee ee ee owe cree eee ee 


xWhen bit 3 equals 1, all other SVC6 functions are _ ignored 
except the Start function and send start options. If the 
calling task terminates while the directed task is being 
loaded, the load continues, no trap occurs, and no status is 
stored in the parameter block error status field. 


*xSelf-directed task generating device functions can be executed 
if bit 5 equals l. , 


6.2.5 Task Resident (SFUN.HM) Function 


The task resident function makes the directed task memory 
resident regardless of what options were specified by Link. 


At end of task, the open logical units of a resident task are 
checkpointed and the task remains in memory. A resident task can 
be rollable. The required parameter block fields are: 


e Task name field (SVC6.ID) 


e Bits 0, 1 and 8 of the function code field 
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6.2.6 Suspend (SFUN.SM) Function 


The suspend function places the directed task into a wait state. | 
The required parameter block fields are: 


e Task name field (SVC6.ID) 


e Bits O, 1 and 9 of the function code 


The directed task remains in the wait state until an SVvVC6 
releasing the suspended task (bit 24 of the function code) is 
executed. If this call is self-directed, it causes the calling 
task to suspend itself. To release the calling task from the 
wait state, another task must be available to subsequently 
release it. 


This function can be used to suspend execution of auxiliary 
processing unit (APU) active or ready tasks. See the 0S/32 
System Level Programmer Reference Manual for more information on 
using SVC6 in a Perkin-Elmer Model 3200MPS System. 


6.2.7 Send Data (SFUN.DM) Function 


Blocks of data that are communicated from one task to another are 
called messages. The send data function allows a task to. send 
variable length messages to another task. 


6.2.7.1 Send Data Message Buffer for Sending Task 


To pass a message from one task to another via the send data 
function, certain data structures are required. The most 
important of these structures is the send data message buffer. 
The structure of this message buffer allows the directed task to 
receive a variable length message in the format in which it was 
sent. The maximum length of a message that can be sent is 
determined by the size and number of the message buffers set up 
by the directed task to receive the message. However, the actual 
length of the message is determined by the number and size of 
message buffers set up by the task issuing the SVC6. 


Hence, two data structures are required by the calling task: the 
SVC6 parameter block and the send data message buffer. The 
required SVC6 parameter block fields for this function are: 

@e Task name field (SVC6.ID) 

e Bits 0, 1 and 10 of the function code field 

e Address of the buffer containing the message to be sent 


(SVCG.MSG) (if a chain of buffers is to be sent, only the 
address of the first buffer in the chain is required) 
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The format of the send data buffer for the calling task is shown 
im Figure 6-4. 


10(00) 11(01) 
{| Function code | Buffer link address 

(SBE: FC) (SBF .NXT) | Header 
De a a a a cs Lee as eon a te tas “ts tac peace re ame eee ste as aw te reo chee Sos eS Stem eee, ee ee em ‘ 

i ee ae ae ed Wr eee et ce ee ae ' 

14(04) } 6(06) 1 
Reserved i Message field length jj; 

(SBF .MLEN) H -(SBF .LEN) 

is SS SS SS A SS SS So a eg egy en gg 1 

18(08) Reserved (ist buffer only) 

or 
Beginning of message H 

(SBF .DATA) H 

Be ee ee ee ee we we a ee a a a ee ee ee ee we ee nee ee we we ee ee ee ee ee ee ee ee ee ! 

Pie a ee Pe es CeO fete eee ee er ' 

1 16(10) Reserved for sending task name 

(lst buffer only) | Body 

H or 1 Of 

H Continuation of message | Message 
ee ee a a we a a ee ee ee ee ee ee ee ee ee ees ee ee ln ee ee ee en ee et ee ee | 

124(18) ! 


eco me es ey me eres maces cee ee ee ee eee ee eee ee ee ee ee eee ee ee oe ee ee ee ee ee ee ee 


Figure 6-4 Send Data Message Buffer Format for Calling Task 


Each send data message buffer can vary in length provided that 
the buffer is aligned on a fullword boundary and its total length 
is equal to an integral number of fullwords. Note that the 
message buffer consists of two parts: the header and the body of 
the message. The message body holds the data that is to be sent. 
Because the send data function allows the size of a message to be 
variable, the length of the body is determined only by the 
quantity of data that is to be sent by SVC6. 


Note that if the buffer is the only buffer containing the message 
to be sent (or the first buffer in a chain), the first 16 bytes 
of the message body are reserved and filled with zeros. When the 
message is transferred to the directed task buffer, the first 
eight bytes of the message body of the directed task buffer are 
filled with zeros, the next eight bytes are filled with the 
sending task's name (left-justified and padded with blanks). All 
remaining buffers in the chain use these first 16 bytes of the 
message body to hold data. 
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A description of the fields in the message header follows: 


Function code is a l-byte field indicating whether 

(SBF .FC) buffer is the only buffer to be sent or is 
member of a message buffer chain. 
function codes are: 


e x'Qao' indicates that the buffer is 
intermediate buffer in a chain. 


@® xX'10' indicates that the buffer is the last 


buffer in a chain. 


e xX'20' indicates that the buffer is 
first buffer in a chain. 


e X'30' indicates that the buffer is the only 


buffer to be sent. 


Buffer link is a 3-byte field specifying the address 

address the next buffer in the chain. The operating 

(SBF .NXT) system ignores this field in buffers with 
a function code of X'10' or X'30'. 

Reserved is a 2-byte field reserved for use by the 

(SBF .MLEN) directed task. 

Message field is a 2-byte field specifying the length in 

length bytes of the message body for that buffer. 

(SBF .LEN) This length must be a multiple of 4. 


6.2.7.2 Free Send Data Message Buffers for Receiving Task 


Before a directed task can receive a message, the following 


structures must be contained within the task address space: 


@e Free send data message buffers 
e Free buffer list queue 
e Task queue 


e User-dedicated location (UDL) containing the address’ of 


task queue, free buffer list queue and TSW with address of 


send data trap service routine 


e TSW initialized to enable send data traps 
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The total length of the send data message buffers should be 
sufficient to hold the entire message transferred to those 
buffers by the calling task. The format of the send data message 
buffers is shown in Figure 6-5. 


cree ce ee ame eee ce ee es em em me ee ee cee ee ee ee ee ee ee ee ee ee ee eee ee oe es ee ee ee ee ee ee ee ee ee ee eee 


10(00) 11(01) 
H Reserved H Reserved H 

H (SBF .FC) H (SBF .NXT) | Header 
[ebeee nee aeee bla lee see a eee ese eae ee eee sees 

14(04) | 6(06) | | 

1 Maximum message length | Reserved H 

H (SBF .MLEN ) H (SBF .LEN) | 

bees @ saa eee BcLGE STORE GLEE aT EER Ee SeTarses sree 

18(08) Reserved (lst buffer only) 

or 
Beginning of message H 

i (SBF .DATA) 

[oo Se ee Se eee See ene eee ae ee 

}16(10) Sending task name | 

(lst buffer only) | Body 

or i; of 
Continuation of message ;} Message 
I ee ups ii, ot "Sw hsm: Ss Sg ak phn” Nal: os ac si Sp < Ses Sa e-store: aig ea ar Gack sas spa crn “aa a 1 

Wed ea te ef a es gt oN, gag tS NR Segoe eae mh Be S at can ase ae 4 

124(18) 
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Figure 6-5 Send Data Message Buffer Format for Directed Task 


Like the calling task's message buffers, each free message buffer 
can vary in length as long as the buffer is fullword 
boundary-aligned and the total length in bytes is an _ integral 
number of fullwords. 


When initialized, the maximum message length field contains’ the 
number of bytes that are available for the body of the message. 
The remaining fields of the message header are reserved. 


The address of each of the free message buffers is placed on a 
standard Perkin-Elmer circular list established in the task 
address space. This list is known as the free buffer list queue. 
The address of the queue is placed in the UDL.SDQ field of the 
UDL. 
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When a calling task issues an SVC6 to send a message, the 
operating system takes the address of the free buffer list queue 
from the UDL and then takes a free buffer address off the queue. 
Once the free buffer is found, the operating system sets the 
reserved field of the message body to blanks and enters the name 
of the calling task in the sending task name _ field 
(left-justified and padded with blanks). After the buffer is 
filled with the data from the calling task's message buffer, the 
operating system places the number of bytes of the message body 
(including the reserved and sending task name fields) into 
SBF .LEN. 


If the entire message has not been transferred, the operating 
system fetches the address of another free message buffer, places 
the address of this buffer in the SBF.NXT field and sets the 
function code. It then begins transferring message data to the 
free message buffer, the address of which is now specified by 
SBF.NXT. However, this time the message data begins at the first 
fullword following the SBF.LEN field. After this buffer is 
filled, the length of the message body is placed in the SBF.LEN 
field. The value in this field can never be larger than the 
maximum message length field. 


The operating system continues to fetch and fill the directed 
task's free buffers until the entire message is tranferred or 
until no buffers are left on the queue. If the directed task 
runs out of buffers to hold the message data, the entire message 
is returned to the calling task buffers. The addresses of the 
directed task buffers are returned to the queue. The operating 
system outputs an error message indicating no message was sent. 


If the entire message is successfully transferred, the operating 
system places reason code xX'04' and the address of the first 
filled message buffer on the task queue of the directed task. If 
the directed task has been properly initialized to receive a task 
queue trap, the task then branches to a trap-handling routine to 
process the message. It is good practice to have the 
trap-handling routine return each message buffer address to the 
free buffer list queue after the data in that buffer is 
processed. See the O0S/32 Application Level Programmer Reference 
Manual for more information on preparing directed tasks to handle 
send data traps. 


If the directed task trap structures have not been properly 
initialized (e.g., mo task queue has’ been established), the 
message is returned to the calling task. 


6.2.7.3 Sample Programs Using SVC6 Send Data Function 


The following sample programs demonstrate the data structures 
used to send a message via the SVC6 send data function. 
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Sample send data application: Sending Task 


MLIBS 8,9 
$SVC6 
SEND DS SVC6. START THE PCB 
SENDE EQU - END OF PCB 
ORG SEND+SVC6.ID GO INTO THE I.D. FIELD 
DB C'RECDATA' STORE THE TASKID 
ORG SEND+SVC6.FUN GO TO THE FUNCTION FIELD 
DC SFUN.DOM!SFUN.DM SEND DATA: OTHER TASK 
ORG SEND+SVC6 .MSG GO TO ADDR OF DATA FIELD 
DC A(MES1) STORE THE ADDR OF THE 1ST BUFFER 
ORG SENDE GO TO THE END OF THE PCB 
MES 1 EQU x ADDR OF 1ST BUFFER 
DC ¥'20000000'+A(MES2) 1ST BUFF+ADDR OF 2ND 
DC H'O! NOT USED BY CALLER 
DC H'80' # OF BYTES WE ARE SENDING 
DS 8 RESERVED FIELD FOR 1ST BUFFER 
DS 8 SENDING TASK NAME FOR 1ST BUFFER 


DC C'THIS IS A MESSAGE FROM ANOTHER TASK.' 
DC C'WITH THE SEND' 


DC C? ‘ TOTAL 80 BYTES 
ALIGN 4 
MES 2 EQU * ADDR OF 2ND BUFFER 
DC Y'O'+A(MES3 ) MIDDLE BUFFER + ADDR OF NEXT BUFF 
DC H'O' NOT USED BY CALLER 
DC H'80! # OF BYTES WE ARE SENDING 


DC C' DATA FUNCTION WE CAN SEND '. 
DC C'VARIABLE LENGTH MESSAGES TO TASKS. ' 
DC C'THIS EXAMPLE' 


DC C* ; TOTAL 80 BYTE BUFFER 
ALIGN 4 

MES3 EQU x ADDR OF 3RD BUFFER 
DC Y'10000000' LAST BUFFER IN CHAIN CODE 
DC H'O' NOT USED BY CALLER TASK 
DC H'80' # OF BYTES WE ARE SENDING 


DC C' SENT 3 BUFFERS AS ONE MESSAGE ' 
DC C'FROM ONE TASK TO ANOTHER ' 
DC C'AS ONE MESSAGE' 


DC Cc’ : 
START EQU i LET'S GO 
SVC 6,SEND SEND THE DATA 
LH 1,SEND+SVC6.STA GET THE STATUS 
BNZ ERROR AND BRANCH IF AN ERROR OCCURRED 
Svc 3,0 EOT 
ERROR EQU * 
svc 3,1 RETURN CODE OF 1 ON ERROR 
END START TRANSFER ADDR 
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Sample send data application: Receiving Task 


MLIBS 8,9 
$VOL 
$SVC1 
$TSW 
MBF STRUC STRUCTURE FOR THE MESSAGE BUFFER FORMAT 
SBF .FC EQU * FUNCTION CODE FIELD 
SBF.NXT DS 4 ADDR OF NEXT BUFFER 
SBF .MLEN DS 2 MAX LENGTH OF BUFFER 
SBF.LEN DS 2 LENGTH OF DATA TRANSFER 
SBF .DATA EQU i START OF DATA AREA 


ENDS 

MYUDL DS 256 START OF UDL 

MYUDILE EQU- * END OF UDL 
ORG MYUDL+UDL.TSKQ GO TO TASK Q ADDR 
pc A(TRAPQ) STORE ADDR OF TASK QUEUE 
ORG MYUDL+UDL.SDQ GO TO ADDR OF FREE BUFFER LIST 
DC A (QUEUE) STORE ADDR OF FREE BUFFER LIST 
ORG MYUDL+UDL.TSKN GO TO NEW TSW AREA FOR Q SERVICE 
pc 0 STATUS OF NEW TSW 
pc A(QSERVICE) LOCATION COUNTER OF NEW TSW 
ORG MYUDLE GO TO END OF THE UDL 

START EQU * LET'S GO 
LA 1,BUFF1 GET THE ADDR OF BUFF1 
ABL 1,QUEUE ADD TO BOTTOM OF FREE LIST 
LA 1, BUFF 2 GET THE ADDR OF BUFF2 
ABL 1,QUEUE ADD TO BOTTOM OF FREE LIST 
LA 1, BUFF3 GET THE ADDR OF BUFF3 
ABL  1,QUEUE ADD TO FREE LIST 
svc 9,TSW ENTER TRAP WAIT 

x 

QSERVICE EQU- * TRAP ROUTINE 
RBL 3,TRAPQ GET THE REASON CODE 
LR 2,3 STORE IT IN 2 
NI 2,Y¥'FFOOO000' CLEAR THE FIELD 
CI 2,TRC.SDTA IS IT A SEND DATA REASON CODE 
BNE ERROR BRANCH IF NOT 

DATA EQU * 
i 2,0(3) GET THE FUNCTION CODE 
NI 2,Y'FFOOOO0O' STRIP OFF THE ADDR 
CI 2,¥'20000000' IS l'T THE FIRST BUFFER 
BE FIRST 
CI 2,¥'10000000! IS IT THE LAST BUFFER 
BE LAST 
CI 2,¥'30000000' IS IT THE ONLY BUFFER 
BE ONLY 
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NEXT 


FIRST 


LAST 


ONLY 


FINI 
x 


GET THE STARTING ADDR OF BUFF 
GET THE LENGTH OF DATA TRANSFER 
ADD STARTING ADDR 

SUBTRACT ONE FROM ENDING ADDR 
STORE THE STARTING ADDR 

ENDING ADDR 

WRITE THE NEXT BUFFER 

GET THE ADDR OF THIS BUFFER 
STORE IN THREE 

CONT INUE 


GET THE STARTING ADDR OF DATA 
GET THE LENGTH OF DATA TRANSFER 
ADD THE STARTING ADDR 

SUBTRACT ONE FROM ENDING ADDR 
STORE THE STARTING ADDR 

STORE THE ENDING ADDR 

WRITE THE FIRST BUFFER 

GET ADDR OF FIRST BUFFER 

SAVE IN THREE 

CONT INUE 


GET THE STARTING ADDR 

GET THE # OF BYTES TRANS 
ADD TO MAKE ENDING ADDR 
SUBTRACT ONE FROM END 
STARTING ADDR 

ENDING ADDR 

WRITE OUT THE LAST BUFFER 


GET THE STARTING ADDR 
GET THE # OF BYTES TRANS. 
GET AN ENDING ADDR 
SUBTRACT ONE 

STARTING ADDR 

ENDING ADDR 

WRITE THE ONLY BUFFER 


THE OS REMOVES FROM THE TOP OF THE FREE LIST 


EQU * 
LA 8,MBF(3) | 

LHL 9,SBF.LEN(3) 

AR 9,8 

SIs 9,1 

ST 8,WRITE+SVC1.SAD 
ST 9, WRITE+SVC1. EAD 
svc 1,WRITE 

L 2,0(3) 

LR 3,2 

B DATA 

EQU * 

LA 8,MBF+16(3) 

LHL 9,SBF.LEN(3) 

AR 9,8 

SIS 9,1 

ST 8,WRITE+SVC1.SAD 
ST 9,WRITE+SVC1.EAD 
svc 1,WRITE 

L 2,0(3) 

LR 3,2 

B DATA 

EQU * 

LA 8 ,MBF (3) 

LHL 9,SBF.LEN(3) 

AR 9, 

SIS 9,1 

ST 8,WRITE+SVC1.SAD 
ST 9, ,WRITE+SVC1. EAD 
Svc 1, WRITE 

EQU * 

LA 8,MBF+16(3) 

LHL 9,SBF.LEN(3) 

AR 9,8 

SIS 9,1 

ST 8,WRITE+SVC1.SAD 
ST 9,WRITE+SVC1. EAD 
Svc 1,WRITE 

EQU * 

LA 1, BUFF1 

ABL 1,QUEUE 

LA 1, BUFF2 

ABL 1,QUEUE 

LA 1, BUFF3 

ABL 1,QUEUE 

LIS 1,0 

ST 1,UDL.TSKO 

svc 9,UDL.TSKO 

EQU- * 

svc 3,2 

ALIGN 4 

DS SsvVcl 


ADDR OF 1ST BUFF 
ADD TO FREE LIST 
ADDR OF 2ND BUFF 
ADD TO FREE LIST 
ADDR OF 3RD BUFF 
ADD TO FREE LIST 
GET A ZERO 

ZERO THE STATUS 

LOAD A TSW 


RETURN CODE OF 2 


START OF PCB 
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WRITEE EQU * END OF PCB 


ORG WRITE+SVC1L.FC GO TO THE FUNCTION CODE FIELD 
DB SVL.WRITISV1L.WAIT WRITE AND WAIT 
ORG WRITE+SVC1.LU GO TO THE LU FIELD 
DB 2 LU 2 FOR A WRITE 
ORG WRITEE GO TO END OF PCB 
ALIGN 4 
TSW EQU) * NEW TSW 
pc TSW.WIM!TSW.TSKM!TSW.SDM WAIT,Q TRAP,SEND DTA 
Dc 0 LOCATION COUNTER 
ALIGN 4 
QUEUE DLIST 3 FREE LIST SIZE 
TRAPQ DLIST 3 TASK QUEUE SIZE 
BUFF 1 EQU- 1ST BUFF 
DS 4 FUNCTION CODE AND LINK ADDR 
Dc H'80' MAX SIZE OF THIS BUFFER 
pc H'O! # OF BYTES TRANS. SET BY OS 
Ds 16 RESERVED FIELD FOR 1ST BUFFER 
DS 80 # OF BYTES WE CAN ACCEPT IN BUFF 
BUFF 2 EQU * 
Ds 4 FUNCTION CODE AND LINK ADDR 
pc H'80' MAX SIZE OF THIS BUFFER 
pc H'Q! # OF BYTES TRANS SET BY OS 
DS 80 # OF BYTES WE CAN ACCEPT IN BUFF 
BUFF 3 EQU * 3RD BUFF 
DS 4 FUNCTION CODE AND LINK ADDR 
pc H'80' MAX SIZE OF THIS BUFFER 
pc H'O! # OF BYTES TRANS SET BY OS 
Ds 80 # OF BYTES WE CAN ACCEPT IN BUFF 
END START TRANSFER ADDR 


6.2.8 Send Message (SFUN.MM) Function 

The send message function allows the calling task to send a 
64-byte message to the directed task. SVC6 appends the calling 
task name to the message, finds the address of the receiving task 
buffer in the UDL of the directed task, fills the receiving 
buffer, and places the address of that buffer onto the directed 
task queue. 


The required SVC6 parameter block fields are: 


@ Task name field (SVC6.ID) 
e Bits O, 1 and 11 of the function code field 


@ Address of message buffer field (SVC6.MSG) 


48-038 FOO RO2 6-25 


To prepare a directed task to accept the message sent by the SVC6 
send message function: 


@e Allocate message buffers to receive the message. (Use the 
message buffer format described in Section 6.2.8.1.) 


@e Write a routine to service task queue traps as described in 
the OS/32 Application Level Programmer Reference Manual. 


@e Store the address of the receiving message buffer in the 
address of the message buffer ring field in the UDL of the 
directed task. 

6.2.8.1 Message Buffers 


When allocating receiving message buffers for the send message 
function, use the buffer format shown in Figure 6-6. 


PSE pe ee a ee ny Pel a ep ere ae ERP npn 2 t---- 
1 | 
iO; Link | Calling task } Message 
| | address} name i 
ad Ee Aa a i eae led aa i eal Q b---- 
Bytes 

0 3 4 ll 12 75 


Figure 6-6 Message Buffer Format for Directed Task 


This message buffer must be 76 bytes’ long and aligned ona 
fullword boundary-aligned. A description of each field in the 
message buffer format follows. 


Fields: 
Buffer-full is a l-bit field indicating whether or not the 
bit buffer can receive the message being sent from 


the calling task. 
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If bit O equals 0, the buffer is available to 
receive the message. 


If bit 0 equals 1, the buffer is full and the 
message is rejected. After the message sent 
by the calling task is stored in the message 
buffer, the system sets the buffer-full bit to 
l to indicate the message buffer is full. 
After the directed task processes the message, 
the user must reset the buffer-full bit to 0 
to indicate that it is available to receive 
the next message. 


Link address is a 4-byte field containing the address of 
the subsequent message buffer to receive the 
next message sent by the calling task. If 
this field contains an invalid address, the 
call is rejected. 


Calling is an 8-byte field receiving the calling 
task name task's name from the system. 
Message is a 64-byte field receiving the message sent 


by the calling task. 


Using the Link address field, the user can construct the 
following structures from the basic message format: 


@e Single buffer ring 

@e Single buffer chain 

@e Multiple buffer ring 

e Multiple buffer chain 

A single buffer ring consists of one buffer as shown in Figure 
6-7. The buffer-full bit initially should be set to 0, and the 
link address field should contain the buffer's own starting 
address (points to itself). When a message is sent to a single 
buffer ring, the system sets the buffer-full bit to 1. All 


subsequent messages are rejected until the user resets the 
buffer-full bit to O. 
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Starting 
address 
X'150' 


se) 
© 
cr 
© 


Figure 6-7 Single Buffer Ring 


A single buffer chain consists of one buffer as shown in Figure 
6-8. The buffer-full bit should initially be set to 0, and (the 
link address field should contain zeros (terminating the chain). 
When a message is sent to a single buffer chain, the system sets 
the buffer-full bit to 1 and stores the link address field 
contents into the address of the message ring field of the UDL of 
the directed task. All subsequent messages are rejected until 
the user stores the empty buffer address into the UDL address of 
the message ring field and resets the buffer-full bit of the 
empty message buffer to 0. 


Starting 

address 
i ai 

Fs a i at a ae SNE eM NE eS Bey ao, 27 t ae Se Es ek Ss ee ee 
i | 
;O} OOO H Data { 
i 4 
ea al nk Aa ed a 2 ¢-------~-~--------- 
Bytes: 

0° 3 4 75 


Figure 6-8 Single Buffer Chain 


A multiple buffer ring consists of a variable, unlimited number 
of buffers. Each buffer-full bit should initially be set to 0, 
and each link address field should contain the address of a 
subsequent buffer. The last buffer's Link address field should 
contain the first buffer's address (forming a ring). When a 
message is sent to a multiple buffer ring, the first buffer, 
pointed to by the address stored in the UDL address of the 


message ring field, receives the message if the buffer-full bit 
is QO. 
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The system then stores the contents of the first buffer link 
address field into the UDL address of the message ring field. 
That UDL field now points to the second buffer in the ring. If . 
the calling task sends another message, the second buffer 
receives the message if the buffer-full bit is 0. 


The system stores the contents of the second buffer link address 
field into the UDL address of the message ring field, which now 
points to the third buffer in the ring. When the last buffer in 
the ring receives a message and the contents of the link address 
field are stored into the UDL, that UDL field points to the first 
message buffer in the ring. If. the calling task sends’ another 
message, the first buffer receives the message if the buffer-full 
bit is reset to 0; otherwise, the message is lost (see Figure 
6-9). 


Address 

X' 150! Be ee, 

pate re ~ 

tf i 

;O}; 1c8 | Data H 

f | i 

er Seleieiaieieieietetaiataiete 
Address 
x'1c8! 


es ee eee es ee ome ee meee eee mee eee re ee es oe ee 


o 
» 
cr 
9 


a ee Se 


me eee a ome. cane SOs et Ee me Se me! a 


C 
» 
cr 
» 


. 


Figure 6-9 Multiple Buffer Ring 
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A multiple buffer chain consists of a variable, unlimited number 
of buffers. Each buffer-full bit should initially be set to 0, 
and each link address field should contain a subsequent buffer 
address. The last buffer link address field should contain zeros 
(terminating the chain). When a message is sent to a multiple 
buffer chain, the first buffer, pointed to by the UDL address of 
the message ring field, receives the message if the buffer-full 
bit is 0. 


The system then stores the contents of the first buffer link 
address field into the UDL address of the message ring field. 
That UDL field now points to the second buffer in the chain. If 
the calling task sends another message, the second buffer 
receives the message if the buffer-full bit is 0. 


The system then stores the contents of the second buffer link 
address field into the UDL address of the message ring field. 
That UDL field points to the third buffer in the chain. When the 
last buffer in the chain receives a message and the system stores 
the contents of the link address field into the UDL, all 
subsequent messages are rejected until the user stores an empty 
buffer address into the UDL address of message ring field and 
resets the buffer-full bit of that message buffer (see Figure 
6-10). 
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Figure 6-10 Multiple Buffer Chain 
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The following sample programs demonstrate the data structures 
used to send a message via the SVC6 send message function. 


‘ 


Sample send message application: Sending task 


SEND PROG SVC6 EXAMPLE - SEND MESSAGE 
x 
* This task sends a message to task RECEIVE. 
x 
x 
NLSTM 
NLSTU 
$SVC6 
$REGS 
SEND EQU * . 
SVC 6,SVC6 SEND THE MESSAGE 
LB R15,SVC6+SVC6.STA+1 GET ERROR STATUS 
SVC 3,0(R15) END OF TASK 
ALIGN 4 
SVC6 DS SVC6. RESERVE SPACE FOR SVC 6 PBLK 
ORG SVC6+SVC6.ID NAME OF TASK MESSAGE IS SENT TO 
DC C'RECEIVE ' 
ORG SVC6+SVC6.FUN SEND MESSAGE TO ANOTHER TASK 
DC SFUN.DOM!SFUN.MM 
ORG SVC6+SVC6 .MSG ADDRESS OF MESSAGE TO BE SENT 


DC A (MESSAGE ) 


MESSAGE DC C'Message from SEND to RECEIVE ' 
DC G : 
DC c' ? 
END SEND 


Sample send message application: Receiving task 


CEIVE PROG SVC6 EXAMPLE -—- RECEIVE MESSAGE 


This task receives a message sent to it by another 
task. The message is logged to the console device. 


pec a de sea = 


NLSTM 
NLSTU 
$UDL$ 
$REGS 
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et 2 HH 


RECEIVE EQU 
svc 
LI 
LA 
STM 
LA 
ST 
LA 
ST 


LINKRING EQU 


LINKDONE EQU 


SVC 


ee Me He 


QSERVICE EQU 
REL 
BO 
LA 
SRL 
CLHI 
BNE 
LA 
ST 
SVC 
L 
NI 
ST 
L 
CLI 
BNE 
SVC 
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b 4 


2,FETCHPTR 
R14,TSW.PMM 
R15,QSERVICE 


R14,UDL.TSKN(R1) 


R15,TSKQ 


R15,UDL.TSKQ(R1) 


R15,MESSQ 


R15,UDL.MSGR(R1) 


R15,NMESS 
R14,MESSQ 
x 


R15,1 
LINKDONE 
R13,76(R14) 
R13,0(R14) 
R14,R13 
LINKRING 


x 


R13 ,MESSQ 
R13,0(R14) 


9,TRAPENA 


Service task queue traps 


* 


R2,TSK 
QEMPTY 
R15,0(R2) 
R2,24 

R2,6 
QSERVICE 
R14,4(R15) 
14,LOGMESS+4 
2, LOGMESS 
RO,O(R15) 
RO,Y'7FFFFFFF' 
RO,O(R15) 
RO, 12(R15) 
RO,C'STOP' 
QSERVICE 

3,0 


Set up UDL and link message buffers into a message ring. 


GET ADDRESS OF UDL IN RO1 

ALLOW MESSAGES TO BE QUEUED 
ADDRESS OF QUEUE SERVICE ROUTINE 
SAVE TASK QUEUE NEW TSW 

ADDRESS OF TASK QUEUE 


ADDRESS OF MESSAGE BUFFER RING 


NUMBER OF MESSAGES IN RING 
HEAD OF MESSAGE RING 


GET ADDRESS OF NEXT BUFFER 
LINK NEXT TO CURRENT 
CURRENT IS NEXT 

CONTINUE LINKING OF RING 


ADDRESS OF FIRST MESSAGE 
LINK FIRST TO LAST 


ENABLE RECEIVE OF MESSAGES 


AN ITEM ON THE TASK QUEUE? 

NO - ENTER TRAP WAIT 

GET PARAMETER 

ISOLATE REASON CODE 

MESSAGE RECEIVED? 

NO - IGNORE IT 

SKIP OVER MESSAGE LINK 

ADDRESS OF MESSAGE TO BE LOGGED 
LOG SENDER ID AND MESSAGE 

RESET MESSAGE ACTIVE FLAG 


GET FIRST FOUR BYTES OF MESSAGE 
IS IT "STOP"? 

NO - CHECK FOR MORE MESSAGES 
YES - STOP TASK 


QEMPTY EQU- * 
svc 9,TRAPWAIT ENTER TRAP WAIT 


ALIGN 4 
TRAPENA DC TSW. PMM,0O 


TRAPWAIT DC TSW.WIM! TSW. TSKM! TSW. PMM, 0 


FETCHPTR DB 0,5,0,ROL FETCH UDL POINTERS 
LOGMESS DB X'40',7 

DCX 72 

pc a) 
TSKQ DLIST 5 TASK QUEUE 
NMESS EQU 3 NUMBER OF MESSAGE BUFFERS 
MESSQ DS 76*NMESS MESSAGE BUFFERS 


END RECEIVE 


6.2.9 Queue Parameter (SFUN.QM) Function 


The queue parameter function adds the user-specified parameter, 
located in the task queue parameter field of the parameter block, 
to the directed task's queue. The required parameter block 
fields are: 


@e Task name field (SVC6.ID) 

e Bits 0, 1 and 12 of function code field 

e Task queue parameter field (SVC6.PAR) 

Before the directed task can receive the parameter sent from the 
calling task, the directed task must prepare to service traps as 
described in the OS/32 Application Level Programmer Reference 
Manual. 

If the directed task's queue is full, the call is rejected, the 


parameter is lost, and an error code is stored into the error 
status field of the caller's parameter block. 
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6.2.10 Change Priority (SFUN.PM) Function 


The change priority function changes the directed task's current 
priority to the user-specified priority located in the parameter 


block change priority field. It then stores the previous 
priority value of the directed task into the current priority 
field of the parameter block. The required parameter block 


fields are: 


@e Task name field (SVC6.ID) 

e Bits 0, 1 and 13 of the function code field 

e Change priority field (SVC6.PRI) 

If the change priority value specified in the parameter block is 
greater than the maximum priority value established by Link, that 
maximum priority is used. However, if the change priority value 
the user specified is outside the range of 10 through 249, the 
call is rejected, and an error code is stored in the parameter 
block error status field (see Table 6-5). 

6.2.11 Send Logical Unit (lu) (SFUN.XSM) Function 

The send lu function assigns to the specified lu of the directed 
task the device or file currently assigned to the specified lu of 
the calling task and then closes the lu assigned to the calling 
task. The required parameter block fields are: 

@e Task name field (SVC6.ID) 

e Bits 0, 1 and 14 of the function code field 

@ Calling lu field (SVC6.CLU) 

@ Receiving lu field (SVC6.DLU) 

Before the directed task accepts the lu that the calling task 
sends: 


e the directed task's lu must not be assigned, and 


e the directed task must be in either a dormant or paused wait 
state or be suspended by an SVC6. 
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6.2.12 Receive Logical Unit (lu) (SFUN.XRM) Function 

The receive logical unit function assigns to the specified lu of 
the calling task the device or file currently assigned to the 
specified lu of the directed task, and then closes the lu 
assigned to the directed task. The required parameter block 
fields are: 

@e Task name field (SVC6.ID) 

e Bits O, 1 and 15 of the function code field 

@e Calling lu field (SVC6.CLU) 


@e Receiving lu field (SVC6.DLU) 
Before the calling task accepts the lu, the directed task sends: 


e the calling task's lu must not be assigned, and 

@ the directed task must be in either a dormant or paused wait 
state or be suspended by an SVC6. 

6.2.13 Connect (SFUN.OM) Function 

The connect function connects the trap generating device 

specified in the device mnemonic field of the parameter block to 

the directed task. The required parameter block fields are: 

e Task name field (SVC6.ID) 

e Bits 0, 1 and 16 of the function code field 

@e Device mnemonic field (SVC6.DMN) 


e Task queue parameter field (SVC6.PAR) 
Before the connection is made: 


e The user-specified device must be a trap generating device. 


e The device must not be currently connected to the directed 
task or any other task; it can be connected to only one task 
at a time. However, a task can be connected to more than one 
trap generating device at the same time. 


e The directed task must be prepared as described in the 0S/32 


Application Level Programmer Reference Manual if traps are to 
be serviced as they occur. 
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When the connection is made and the thaw function is’ specified, 
an interrupt occurs, and the user-specified parameter located in 


the task queue parameter field of the parameter block is placed. 


on the directed task queue with a reason code of 0. The connect 
function does not enable interrupts. The operating system 
provides capabilities to connect APUs as a trap generating device 
to a task. The actual APU signals are defined in the O0S/32 
System Level Programmer Reference Manual. 


6.2.14 Thaw (SFUN.TM) Function 


The thaw function enables interrupts from the specified trap 
generating device connected to the directed task. The required 
parameter block fields are: 


@e Task name field (SVC6.ID) 
e Bits O, 1 and 17 of the function code field 


@ Device mnemonic field (SVC6.DMN) 


Before this function is effected, the task should be prepared to 
handle traps as described in the 0OS/32 Application Level 
Programmer Reference Manual. 


When the thaw function is executed, the system first ensures that 
the trap generating device is connected to the directed task 
specified in the parameter block; it then enables interrupts. 
Interrupts are disabled when the directed task terminates or if 
an unconnect or freeze function is specified. If a thaw function 
is executed when interrupts are already enabled, this call has no 
effect. Note that an APU can be treated as a pseudo trap 
generating device. 


6.2.15 Sint (SFUN.IM) Function 

The sint function simulates an interrupt from the specified trap 
generating device connected to the directed task only if the thaw 
function was specified. If interrupts are disabled, this call 
has no effect. The required parameter block fields are: 

e Task name field (SVC6.ID) 

e Bits O, 1 and 18 of the function code field 


e@ Device mnemonic field (SVC6.DMN) 
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When the simulate interrupt function is executed, the system 
first ensures that the trap generating device is connected to the 
directed task specified in the parameter block; it then simulates 
an interrupt from the specified device. Note that an APU can be 
treated as a pseudo trap generating device. 


6.2.16 Freeze (SFUN.FM) Function 


The freeze function disables interrupts from the specified 
trap-generating device connected to the directed task. The 
required parameter block fields for this function are: 


e Task name field (SVC6.ID) 
e Bits O, 1 and 19 of the function code field 


@ Device mnemonic field (SVC6.DMN) 


When the freeze function is executed, the system first ensures 
that the trap-generating device is connected to the directed task 
specified in the parameter block; it then disables interrupts 
from the specified device. When the freeze function disables 
interrupts, the trap-generating device and directed task remain 
connected, but all generated interrupts are lost. If interrupts 
are already disabled, this call has no effect. Note that an APU 
can be treated as a pseudo trap-generating device. 


6.2.17 Unconnect (SFUN.UM) Function 

The unconnect function disconnects the specified trap-generating 
device from the directed task. The required parameter block 
fields for this function are: 

@e Task name field (SVC6.ID) 

e Bits O, 1 and 20 of the function code field 

@ Device mnemonic field (SVC6.DMN) 

When the unconnect function is executed, the system first ensures 
that the trap-generating device is connected to the directed task 
specified in the parameter block; it then disables all interrupts 
and disconnects the specified device from the directed task. The 


device can now be connected to another task. Note that an APU 
can be treated as a pseudo trap-generating device. 
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6.2.18 Assign Logical Processing Unit (LPU) Function (SFUN.LPU) 
Function 


The assign LPU function assigns the directed task to a new LPU 


number. This assignment has no effect until the directed task is 
transferred by the task dispatcher. The required parameter block 
fields for this function are: 


e Task name field (SVC6.ID) 
e Bits O, 1 and 21 of the function code field 


® LPU assignment field (SVC6.LPU) 


If task mapping to a waiting APU has been changed, the wait 
condition is removed and the APU is restarted. 


6.2.19 Transfer to Logical Processing Unit (LPU) (SFUN.TL) 
Function 


The transfer to LPU function makes the directed task LPU-directed 
and transfers the directed task to its assigned LPU the next time 
the task is dispatched, provided that all requirements for 
transfer are met. See the 0OS/32 System Level Programmer 
Reference Manual for more information on the task dispatcher. If 
this function is self-directed, it duplicates the function of the 
RSCH 2 instruction. If a calling task executing on the CPU 
directs this function to itself, the task is made LPU-directed, 
and the calling task is dispatched to its assigned LPU. If the 
LPU is mapped to the CPU, no transfer occurs. If the LPU is 
mapped to an APU, a transfer to the APU occurs. 


The required parameter block fields for this function are: 


@e Task name field (SVC6.ID) 


e Bits 0, 1 and 22 of the function code field. 


NOTE 


If both bits 22 (SFUN.TL) and 23 
SFUN.TC) are set in the = same SVC6 

parameter block, only bit 23 is 

recognized when the call is complete. 
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6.2.20 Transfer to Central Processing Unit (CPU) (SFUN.TC) 
Function 


The transfer to CPU function makes the directed task 
CPU-directed. As a result, the next time the task is dispatched 
from the CPU ready queue, it will execute on the CPU regardless 
of its LPU assignment and eligibility. If the calling task 
directs this function to a task that is active or ready on an 
APU, the LPU-directed status is reset after the task is returned 
to the CPU for any reason. 


If a calling task executing on the CPU directs this function to 
itself, it duplicates the function of the RSCH O instruction with 
the following exception. 

If the task's TCB specified a trap block, which has a _ nonzero 
wait bit in the SVC new program status word (PSW),the APU halts 
and waits for the task to resume execution on the APU. The APU 
remains halted while the task executes on the CPU until: 

e The task is transferred back to the LPU. 

e The task is assigned to a different LPU. 

e The task goes to end of task or is cancelled. 

e LPU mapping for the task's LPU is changed. 

If a calling task operating on the APU directs this function to 
itself, the calling task is transferred to the CPU. Normally, 
APU processing continues after the task is transferred unless the 
wait bit in the SVC new PSW field of the APU trap block has’ been 
set. In this case, APU processing is explicitly suspended while 
the task executes on the CPU until: 

e The task is explicitly transferred back to the APU via SVC6. 


e The task is assigned to a different APU through an LPU 
assignment. 


@e The task is cancelled or goes to end of task. 

e LPU mapping for the task's LPU is changed. 

See the 0OS/32 Application Level Reference Manual for more 
information on setting the trap block to suspend APU processing. 
The required parameter block fields for this function are: 

e Task name field (SVC6.ID) 


e Bits O, 1 and 23 of the function code field 
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NOTE 


If both bits 22 (SFUN.TL) and 23 
(SFUN.TC) are set in the same SVC6 
parameter block, only bit 23 is 
recognized when the call is completed. 


6.2.21 Release (SFUN.RM) Function 


The release function releases a directed task currently suspended 
by a previous SVC6 by taking it out of a wait state. Once 
released, the task continues executing with the instruction 
following the instruction executed before the task was suspended 
if the task is not in another wait state at this time. The 
required parameter block fields for this function are: 


@e Task name field (SVC6-ID) 
e Bits O, 1 and 24 of the function code field 


The SVC6 release function can be used by a_ system task 
(.CMDP, .CSL, .MTM and .SPL) to remove another task from a 
suspended state. After the task is released, it continues 
execution at the location specified in the SVC6.SAD field of the 
SVC6 parameter block. If this SVC is used by other than a system 
task, the continuation address (SVC6.SAD) is ignored. Figure 3-6 
shows the parameter block format and coding for the SVC6 release 
function for system tasks. 


6.2.22 Nonresident (SFUN.NM) Function 

The nonresident function makes the directed task nonresident 
regardless of the Link options specified. When a nonresident 
task goes to end of task, it is removed from the _ system. The 
required parameter block fields are: 


e Task name field (SVC6.ID) 


e Bits 0, 1 and 25 of the function code field 


6.2.23 Rollable (SFUN.RLM) Function 

The rollable function makes the directed task rollable. The 
Girected task must have been linked as a rollable task. If this 
function is directed to a task linked as nonrollable, an error 
status is returned. The required parameter block fields are: 


e Task name field (SVC6.ID) 


@® Bits 0, 1 and 26 of the function code field 
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6.2.24 Nonrollable (SFUN.NRM) Function 

The nonrollable function prevents the directed task from being 
rolled. The required parameter block fields are: 

@e Task name field (SVC6.ID) 

e Bits 0, 1 and 27 of the function code field 

If both the rollable and nonrollable functions are _ specified, 
only the nonrollable function is recognized. 

6.2.25 Start (Bit Positions 29, 30, 31) Function 

The start function starts execution of the directed task. This 
call is rejected if it is self-directed. Four methods of 
starting are: 

e Start (bit setting equals 010) 

@e Start with start options (bit setting equals 011) 

e Delay start (bit setting equals 100 or 110) 


@ Delay start with start options (bit setting equals 101) 


The required parameter block fields are: 

e Task name field (SVC6.ID) 

e Bits 0, 1, 29, 30 and 31 of the function code field 

e Address of start options field (SVC6.SOP) (only required when 
start with start options or delay start with start options is 


specified in the function code) 


e Increment of time field (SVC6.TIM) (only required when delay 
start or delay start with start options is specified) 


e Count field (SVC6.CNT) (only required when delay start or 
delay start with start options is specified) 

e Starting address of directed task field (SVC6.SAD) 

Before the start function is executed, the directed task must be: 

@ loaded or present in memory, and 


e ina dormant or console wait state. 


6-42 48-038 FOO RO2 


6.2.26 Start Function for SVC6 (SFUN.SIM) Function 


When this function is specified, execution of the directed task 
is started at the address in the parameter block starting address 
of the directed task field. However, if the user-specified 
starting address is 0, the directed task is started at the 
default start address specified by Link. If the user-specified 
starting address is outside the established task boundaries, this 
call is rejected, and an error code is stored in the parameter 
block error status field. 


6.2.27 Start Function with Start Options for SVC6 (SFUN.SOM) 
Function 


When this function is specified, the start options, optionally 
specified in certain language and utility programs at execution 
time, are also included as run-time information when the directed 
task starts execution. When the start function is executed, the 
start options located at the address specified in the parameter 
block are stored into the directed task UTOP area. If sufficient 
memory is not available between UTOP and cCTOP, this call is 
rejected and an error code is stored in the parameter block error 
status field. The task should then be reloaded into a larger 
segment using the extended load option segment size increment 
field. 


The user-specified start options must be located on aé_efullword 
boundary. The maximum length of the start options are defined at 
sysgen through the CMDLENGTH option. If the length of the start 
options is greater than that specified at sysgen or a _ carriage 
return (CR) is present within the start options, only those 
characters up to the maximum number or the CR are stored in the 
task UTOP area. 


Since the address of the start options field is also the address 
of the message buffer field in the parameter block, this field's 
contents are always assumed to be the start option address when 
the start function is specified. 


6.2.28 Delay Start Function for SVC6 (SFUN.SDM) Function 


When this function is specified, the directed task starts 
execution after a user-specified interval located in the 
parameter block increment of time and count fields elapses. This 
can be specified as a time-of-day or interval-timing interval. 


When this start function is executed for the directed task, bytes 


192 through 251 of the directed task's UDL are used by the 
operating system for SVC6 delay start function use. 
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When this start function is executed, the directed task is 
immediately placed into a time wait state. When the 
user-specified interval elapses, the directed task starts 
execution. 


6.2.29 Delay Start Function with Start Options for SVC6 
(SFUN.SDM, SFUN.SOM) 


When this function is specified, the directed task starts 
execution after a user-specified interval located in the 
parameter block increment of time and count fields elapses. The 
interval can be specified as a time-of-day or interval-timing 
interval. 


When this start function is executed for the directed task, bytes 
192 through 251 of the UDL are used by the operating system for 
SVC6 delay start function use. 


When the start function is executed, the start options located at 
the address specified in the parameter block are stored into the 
directed task UTOP area, and the directed task is immediately 
placed into a time wait state. If sufficient memory is not 
available between UTOP and CTOP, this call is rejected, and an 
error code is stored in the parameter block error status field. 
The task should then be reloaded into a larger segment using the 
extended load option segment size increment field (see Section 
6.2.4.2). 


The user-specified start options must be located on aé_e fullword 
boundary. The maximum length of the start options is defined at 
sysgen through the CMDLENGTH option. If the length of the start 
options is greater than that specified at sysgen or a CR is 
present within the start options, only those characters up to the 
maximum number or the CR are stored in the task UTOP area. Since 
the address of the start options field is also the address of the 
message buffer field in the parameter block, this field's 
contents are always assumed to be the address of the start 


options when the start function is specified. When the 
user-specified interval elapses, the directed task starts 
execution. 


6.2.30 Wait Status Field (SVC6.TST) 


The wait status is sent to the wait status field in the parameter 
block each time an SVC6 is executed. 


If the calling task wants to check the wait status of the 
directed task, an SVC6 should be executed with bits 0 and 1 of 
the function code set to 10 and the remaining bits set to 0. 
This operation also causes the current priority field of the 
directed task to be returned to the current priority field in the 
parameter block. Table 6-4 lists the wait status bit 
definitions. 
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TABLE 6-4 WAIT STATUS BIT DEFINITIONS 


a ks ee tome Ae SN me: ene es ree Me SS her femme rw oe eee meme Gee mat Sem nim cme mm tee tern Gt NOS Mem mS ome eens tie SD EE SER Wem ee nomen GER OE EES me me ey. SE me Os ee ee ee 


BIT | WAIT STATUS | 
feeds we ee eee 
| O (10) | X'8000' | I/O queue wait ; ! 
| 1 (CN) | X"4000' } Connection wait 1 
| 2 (CW) | "2000" | Console wait (task paused) | 
| 3 (IM) | X*1000" | Load wait; calling task waiting | 
eee ees te een E ed tied ek ae oa mee, 
! 4 (DM) | X'0800' | Dormant; task not started or at ! 
er Ee eee eee ! 
| 5 (TW) | X'0400' |} Trap wait | 
| 6 (TD) | X"0200' j Time-of-day wait | 
| 7 (TK) | X'0100' | Task suspended | 
| 8 (TM) | X'0080' j Interval wait | 
| 9 (ER) | xX'0040' | Terminal wait | 
| 10 (RO) | X'0020' | Roll pending wait | 
| 11 (11) | X*0010' | Intercept initialization = | 
112 (IT) } X'0008' | Intercept termination = ! 
13 (co) | x*0004’ {Connection wait | 
| 14 (ac) | X'0002" | Accounting wait | 
11S | ~-K'0001' {| Reserved for future use | 


6.2.31 Error Codes (SVC6.STA) 


If an error occurs, execution of the current SVC6 function stops, 
and any other functions specified in the function code to the 
right of the current function are not executed. The position of 
the function code bit, which indicates the function being 
executed when the error occurred, is stored in bits 0 through 7 
of the parameter block error status field. The bit position 
value ranges from 0 to 31. The error code indicating the error 
type is stored in bits 8 through 15 of the parameter block error 
status field shown in Figure 6-11. Table 6-5 lists SVC6 error 
codes. 
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Function code | 
bit position H 


Figure 6-11 Error Status Field 


TABLE 6-5 SVC6 ERROR CODES 


ee ee ee ce eee ree em er ee ee eee ire ees ce ee ee ee ee ee eee me ee ee te ee me ee es ree ee es ee re ee ree ee eee ee ee ces ees ee ee) ee oem nn Ao 


| ERROR i}FUNCTION CODE} H 
H CODE {BIT POSITIONS} 1 
|} HEXADECIMAL} CAUSING THE | H 
Sonia ERROR MEANING 
0 ms All | No error occurred. All requested |} 
| functions terminated normally. ! 
a ea a a a a a a a 
H 1 { All | Syntax error present in parameter | 
i block task name field. This error | 
1 H i Goes not include self-directed H 
| calls. 
SSeS SS eee ea aS eee Se aa ee ee eae a ee SS es 
2 All i ILlegal function code 
a a aa aa a a a a | 
| 3 H 6 (L) | Directed task is already loaded H 
| into memory. 
ak ae li ac a eo la a a 
4 | All except {| The specified directed task is not | 
| H 6 (L) {| present in the calling task | 
1 H } environment. 
a a cca a a a a 
H H 6 (L) | The directed task is not present, 
| but the calling task has the SVC6_ | 
H H | intertask control function dis- H 
H H ;} abled. H 
ae S SS SS SSS Sere a ee See ae ee SS or eee eS ae aaa ae | 
H 5 H 13 (P) | The specified priority is outside jj} 
| of the range of 10 through 249. 
H Sa com iis el: mice‘ mic, Sl ey, ah nb li Vy“ heh ea n,m nck nm cS Ga ca i nS mec vein nc 
6 6 (L) The directed task requires float- 


| ing point facilities that are not | 
! ! 
' t 


sysgened into the system. 
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TABLE 6-5 SVC6 ERROR CODES (Continued) 


ERROR } FUNCTION CODE} 


CODE ‘BIT POSITIONS} 
HEXADECIMAI,! CAUSING THE | 
(DECIMAL) | ERROR MEANING 


2 ee ee ee Se Be Se GE SS EE SSE ED 8 Ee 8 8 E 


! 7 ' 9 (8) 
| 
! 


H | The specified directed task is 
H | Gormant, paused or suspended. The 
14 (B) | specified directed task is not 
15 (V) | dormant, paused or suspended. 
29 
30 (A) 
31 
een ne ea Seep ea ry eae eft ON eer Ce ey ee ene ee een a 
8 11 (M) The message is not fullword 


! ! 
U ! 
29 | boundary-aligned, or an invalid 
' ! 
t t 


30 (A) starting address was specified for 
31 a directed task. 
| cn ei re ip ers: ear noi en is ee a ca ee ee oa aoe aS cea AS ey re See ote oa ee eo ma eo ey es 
| 9 All i The calling task cannot execute 
| SVC6 control or communication 
1 } functions. 
| ee es rts rs Sian mt it (a ae tenes mg i “on i mie Sel a th Mp et et ges 
| A (10) | 29 {| The values specified for the 
30 (A) ; increment of time and count fields 
31 | are invalid. 
| aaa a a as at Fe a a at a ec ml/h sat er as ses vy a ae a 
1 B (11) } 10 (SD) | The calling task message was not 
| H 11 (M) } sent to the directed task. 
H a eh ess Fas Fc San Vn as feminism “eset wi ca aces is cada ya a i Ss sas ec ma Sel ew 
C (12) 10 (SD) Task queue service in the directed 
11 (M) task TSW is disabled. The 
12 (Q) directed task queue is full. The 


| i { 

t 4 t 

| | | 

| | | 

| | directed task has no queue. 

| D (13) $ 16 (0) | The device mnemonic specified in 
t i ! 

! ! ! 


17 (T) the parameter block does not exist 
18 (1) in the system. 
19 (F) 
20 (U) 
| E (14) } 16 (0) } The device mnemonic specified in 
17 (T) | the parameter block is not a con- 
H i 18 (I) | nectable device. 
| 19 (F) 
20 (U) 
tw en ee 
F (15) 16 (0) The device mnemonic specified in 


' 
! 
{| the parameter block is busy and 
} cannot be connected. 


wee wee wees we we we He 
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TABLE 6-5 SVC6 ERROR CODES (Continued) 


ee mes mere ces cee me ee ee ee ee me em Ss ee em cee me ee ce eee eee ee Ge ee ome ee ee ee ee ee ec ee ee ee ee ee ee ee ee ee ee cee ee ee me ee ee ee ee 


ERROR {FUNCTION CODE}; 


t 

I 

CODE {BIT POSITIONS } { 

HEXADECIMAL} CAUSING THE |} H 

(DECIMAL) | ERROR { MEAN ING i 

SSS STS VS SV SSS SS SSS VST SS SS SSS SSS VSS SST SV SSS SS SS SS ES SS ee H 

10 (16) H 17 CT) | The device mnemonic specified in H 

18 (1) } the parameter block is not con- 

H 19 (F) { nected to the specified directed H 

20 (U) ; task. ! 

cee ces nes mee me eres me ere Sm es me ee ee me ese tse ee cee Oe cee ee es ew ne ee mene cane Oe ee inn at Oe ce came Sere tee Oe ene ae OS Se AE OO SY DE Ge SOD | 
11 (17) 6 (L) The lu specified in ne lu to load 


i] I 
1 ! 
| task field of the parameter is | 
| invalid. H 


es cee eS con ee re Ges Ge tree OS cme Ce ES eS me ee: ee ee oe ee Se i ED Se ES SS Se re ee ee ree GY nee nk See mene ee Ge ee a ee es OS ee ee eee 


! 

! 

12 (18) H 14 (B) | The lu the calling task sends or H 

H 15 (V) | receives is greater than the H 

{ maximum allowed value. 

me ee ee a a a ne H 

13 (19) | 14 (B) i The directed task is currently 

15 (V) {} assigned to an lu during a send lu |} 

|} operation. ! 

ee ee ee cr me me cme re ee ce ee ee ee ee ee ee ee a ee ee ee ee ee H 

14 (20) | 14 (B) i} The calling task is currently 

15 (V) } assigned to an lu during a receive } 

| lu operation. 

a ee en ee ae ns ee eee ee ee ee a a a a a a a a H 

16 (22) | 29 i The specified directed task to be | 

30 (A) | started is Currentty rolled out. 

a ee ee a ee a { 

17 (23) | 26 (Y) i The directed task did not specify | 

i the roll option by Link and, 

| therefore, cannot be rolled out. 

18 (24) } 29 i There is insufficient room between | 

30 (A) ; the task UTOP and CTOP to store 

31 | the task-specified start options. | 

ce ee ne mee ee mee me ee ee sme ee me a ee ae ee ee ee H 

19 (25) | 18 (1) i An interrupt cannot be simulated 

i on the specified device. 

ee ne ee ee a i a ee t 

1B (27) | 6 (L) i Loading the direct task exceeds 

i: the maximum number of sysgen- 

i established tasks that can be 

i present in the system at one time. | 

ce ee ce ee ne ee ee ee ee { 

21 (23) | 6 (L) i; An error occurred while loading a } 

; pure segment. 

ee ee ee ee en a H 
42 (66) 6 (L) The run-time library (RTL) or a 


! t 
' ' 
i TCOM required by the directed task | 
i is not present at load time. 
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TABLE 6-5 SVC6 ERROR CODES (Continued) 


se meaner SN NO Ne UOTE) Os Gives Nh Mow ite EG Gwe ree item em ise een eee me come hmm me i ein SS me (rm ee re ee eee i we cee ee em es ee ee ene ce ee es 


ERROR i}FUNCTION CODE} 


{ 
' 
H CODE i{BIT POSITIONS} 
{HEXADECIMAL |} CAUSING THE |} 
{ (DECIMAL) } ERROR MEAN ING 
i Tae Tes oe See nas es ee ee ee oe ae a a a > Sa ae ome camp ce Seas oak ‘Sas vakh Sas cams Sas ‘Soe SOG CSS seat ‘sem “Sos Tes cam Sm cams mee Somp Sams ame wat Skee came cet cmp Sm POMS aS Sams SES Tee ToS SS FS ee OS See EB oo 
, 43 (67) } 6 (L) | The calling task specified load 
i H | options and the directed task 
| specified Link options are not the 
{ same. 
{ ~ a a a i se as in rs ks ea ope a a sf ee cee, nn es ee a ee ne a St 
| 44 (68) } 6 (L) i The LIB format is invarid: 
H fg ah ci ws ei vtec ab es ns ee a omc sem Tome Gk wb ee” inn nh uc “te aan (Se es nc cn“ “au ls es fa cs sessed eC 

45 (69) 6 (L) TAgUEPACI SHE system space exists 

14 (B) to load or start the directed 
task. There is insufficient 


to accept the lu of the calling 
task being sent. 

{ RE CeiipE was made to load tree- 

| structured overlays from a device 

} that does not support random 

| access. 

Syavaih does not support loading 

of tree- structured overlays. 

| Data in the ODT of a three- 

|} Structured overlay is invalid. 

| Memory does not have a large 

{ enough area into which the 
' 
7 
| 


29 } system space in the directed task 
| 
! 


directed task can be loaded. The 
roll option was not specified as a 
Link option. 
| An error occurred while mapping a 
{| shared segment. Previously mapped 
{| or shared segment table was full. 
| The allocation of or assignment to 
i the specified roll file is invalid, 
| and the task cannot be loaded. 
{ An I/O error occurred when the 
| directed task was rolled out 
} (written) to the roll volume; it 
} cannot be loaded back into memory. 
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TABLE 6-5 SVC6 ERROR CODES (Continued) 


ERROR {FUNCTION CODE} 
CODE iBIT POSITIONS} 
i{HEXADECIMAL| CAUSING THE j 
i (DECIMAL) | ERROR MEAN ING 
i SSS SSS VST eV SS SSS VSS SSATCSECESE ST SISSIES SSS SSS SSS SSS VSS SS SSS SS SS SS H 
i; 52 (82) H 6 (L) | The physical size of a sharable H 
| gegment was smaller than the ! 
{ minimum size required. ! 
cla a ave ass aS RR aict Ra aes mee FOR a | 
' 53 (83) | 6 (L) | The access privileges of a 
| sharable segment were incompatible | 
| with those requested by the task. | 
(Se eS Sra ee Se a et eg ee 
i 54 (84) | 21 (AP) | The LPU number is outside the 
i | range specified by the MAXLPU 
; parameter at sysgen. 
a aaa a a a ra 
¢ 95 (85) | 21 (AP) i The directed task is an APU-only 
i 23 (IC) i task and cannot be transferred to | 
i ; the CPU. 
Te eceia chang eiae neta cate ana ariel aera ae ma ea ee ae Tea aoe | 
80-FF 6 (L) An I/O error occurred when the 
directed task was being loaded 


(read) into memory. 
occurred. 


An SVCl error 


The calling task can check the parameter block for functions’ the 


directed 


task 


functions that were not executed. 


executed before the error occurred and for 
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CHAPTER 7 
FILE HANDLING SERVICES SUPERVISOR CALL 7 (SVC7) 


7.1 INTRODUCTION 


SVC7 provides file and device handling functions supported by the 
file manager and the data communications’ subsystem. These 
functions are accomplished through the SVC7 parameter block shown 
in Figure 7-1. For a description of the 0S/32 file management 
services, see the O0OS/32 Application Level Programmer Reference 
Manual and the OS/32 Basic Data Communications Reference Manual. 
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0(0) }2(2) 13(3) logical 
Function code | Error status {| unit (lu) 
(SVC7.OPT) ! (SVC7.STA) ' (SVC7.LU) 

4(4) 15(5) 16(6) 

Write key Read key H Logical record length 
(SVC7 .WKY ) i (SVC7.RKY) | (SVC7.LRC) 

8(8) 

Volume name or device mnemonic 
(SVC7.VOL) 

12(C) 

ea Filename ----- 

16(10) (SVC7 .FNM) 

20(14) 423(17) File 

Extension {| class/account 
(SVC7 .EXT) i (SVC7 .ACT) 
24(18) 
File size 
(SVC7.SI1Z) 
SVC 7,parblk 
ALIGN 4 
parblk DC X'function code! 
DS 1 
DB lu 
DB ‘write key' 
DB ‘read key' 
DC H'record length' 
DC C'4-character volume name or device 
mnemonic' 
DC C'8-character filename' 
DC C'3-character extension' 
DB C'file class' 
DC F'file size' 


Figure 7-1 SVC7 Parameter Block Format and Coding 
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This parameter 


block must be 28 bytes long, fullword 


boundary-aligned and located in a task-writable segment. A 
description of each field in the parameter block follows: 


Fields: 


Function 
code 
(SVC7.OPT) 


Error 
status 
(SVC7.STA) 


lu 
(SVC7.LU) 


Write key 
(SVC7.WKY) 


Read key 
(SVC7.RKY) 


Logical 
record 
length 
(SVC7.LRC) 
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is a 2-byte field that contains the 
hexadecimal number indicating the function to 
be performed. 


is a l-byte field that receives the 
appropriate error code when an error occurs 
while executing SVC7. If no error occurs, a 
value of O is stored in this field. 


is a l-byte field that contains a hexadecimal 
number indicating the logical unit used for 
all SVC7 functions (except the allocate and 
delete functions). 


is a 1-byte field that contains a hexadecimal 
number indicating the write protection keys 
for direct access and data communications 
files and devices when the allocate, assign, 
reprotect and delete functions are executed. 


is a l-byte field that contains a hexadecimal 
number indicating the read protection keys for 
direct access and data communications files 
and devices when the allocate, assign, 
reprotect and delete functions are executed. 


When executing the SVC7 fetch attributes 
function, the device and file attributes are 
stored in the write and read key fields of the 
parameter block. 


is a 2-byte field that contains a decimal 
number indicating the logical record length 
for indexed files, nonbuffered indexed files, 
or buffered logical terminal manager 
(communications). 


When executing a fetch attributes function, 
this field receives a device physical record 
length. | . 


Volume name 
or device 
mnemonic 
(SVC7.VOL) 


Filename 
(SVC7.FNM) 


Extension 
(SVC7.EXT) 


File class/ 
account 
(SVC7.ACT) 


is a 4-byte field that contains the ASCII code 
indicating the volume name of a direct access 
device, the device mnemonic of a nondirect 
access device or the name of the data 
communications access line, when the allocate, 
assign, delete and fetch attributes functions 
are executed. 


is an 8-byte field that must contain the ASCII 
code indicating: 


e A filename on a direct access device when 
the allocate, assign, rename and delete 
functions are executed; a filename is not 
required for nondirect access devices. 


e The buffered logical terminal described by 
the line control block (LCB) that is being 
allocated or assigned . 


When executing a fetch attributes function, 
this field receives the filename from the 
Girect access or data communications device 
currently assigned to the lu specified in the 
parameter block. If it is a nondirect access 
device, this field is blank. 


is a 3-byte field that contains the ASCII code 
indicating further identification of the 
filename or the file type (.CAL, .OBJ, .TSK, 
-CSS) on direct access devices. 


is an optional l-byte field that contains the 
account number or class to which the file is 
allocated. If SVC7 is issued by an executive 
task (e-task) or a user task (u-task) that was 
link-edited with the ACPRIVILEGE option, an 
account number can be specified in this field. 


NOTE 


To specify a file with an account 
number, the file descriptor (fd) 
must be packed into the SVC7 
parameter block using SVC2 code 16 
(see Section 3.14.9). The account 
number can range from 0 to 65,535. 
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If SVC7 is issued by a u-task that was 
link-edited with the NACPRIVILEGE option, the 
file class is specified as follows: 


@ /P indicates the file is allocated under 
a private account. 


e /G indicates the file is allocated under 
a group account. 


e /S indicates the file is allocated under 
a system account. 


See the OS/32 Link Reference Manual for more 
information on the account privileges task 


option. 
File size is a 4-byte field that contains a hexadecimal 
(SVC7.SIZ) number indicating the file size established 
when a file is allocated to a direct access 
device. 


7.2.1 Function Code Field (SVC7.OPT) 


SVC7 has nine functions specified by the first byte of the 
function code, called the command byte, and has four modifier 
fields specified by the second byte of the function code, called 
the modifier byte. The modifier fields are: 


e Access privileges for the allocate function and change access 
privilege function 


@ Access method (data communications only) for the assign 
function 


@ File types for the allocate function 

@ Density selection for the assign function (magnetic tape 
drives) 

There are no modifier fields for the rename, reprotect, close, 

delete, checkpoint and fetch attributes functions. 

These functions and modifier fields are specified through 

different function code bit settings shown in Figure 7-2. The 


functions specified in the function code are executed from 
left-to-right. 
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Command byte 


Modifier byte 


a iene mee cee macnn. ew ek; me SED GD ee ee me a ee SE Se ee Ge ee me me me Gee Se eS ee Se GS ee ees ee ee ee ee ce 


c |] D}{C { Access {Access | File i 
L | L | K {privileges |method | types \ 
10 11 12 13 15 


Figure 7-2 S8VC7 Function Code Field 


The 


is explained in Table 7-1. 


function of each bit setting in the SVC7 function code field 


TABLE 7-1 SVC7 FUNCTION CODE BIT DEFINITIONS 


Ree ee ee eee 


DEVICE/F ILE 


me cece cs ee ee we ne ee ee ee we we we ee ee ee ee ee oe ee 


DATA 
COMMUN I CATION 


BIT SETTING 


H 

1 

BIT 

| POSITION | FUNCTION 
‘ 

i] 

i O (AL) } Allocate 
i i] 

! { 

j H 

H H 

' H 

t 

; 1 (AS) | Assign 
) { 

! | 

i | 

i 

i H 

H H 

{ 

1 2 (CH) { Change 
1 ! access 
} privi- 
{| lege 

H { 

H H 

1 H 

1 

7-6 


Reserves space 


on a direct 
access device. 


Assigns an lu 
to a device or 
file. 


Changes the 


user's current 


access privi- 
lege to a new 
access privi- 
lege. 


Reserves an 
LCB for a 
buffered 
terminal 
manager. 


Assigns an 
lu to line 
driver 
(SVC15) and 
terminal 
managers 
(SVCl1). 


Changes the 
communica- 
tions user 
current 
access privi- 
lege to a new 
access privi- 
lege. 


] 
t 
t 
i] 
| 
i 
1 
H 
no function} 
H 
t 
| 
‘| 
J 
] 
{ 
‘] 


0 = 
requested 
l = reserve 
space 
0 = no function} 
requested |} 
1 = assign an |} 
lu } 
! 
0 = no function} 
requested | 
1 = change 
access | 
privilege j; 
' 
: 
i 
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TABLE 7-1 SVC7 FUNCTION CODE BIT DEFINITIONS (Continued) 


H i MEANING { 

H ata cai an aaa aan aan rar aaa H 

BIT | DATA 

} POSITION } FUNCTION | DEVICE/FILE. } COMMUNICATION | BIT SETTING 

| See EE SESE SE ESE ESSE SES SEES SS Sse sess See cesses | 
i} 3 (RN) i; Rename |} Changes the } Changes the i O = no function} 
} current file- {| name of the requested j| 
H 1 } name to a new | communica- } 1 = change | 
{| user-specified { tions line filename 
H H | filename. } (SVC15) or H H 
| terminal 
| | (SVC1l.) 
Sakae Sea Se SS SS SS SSeS aS Se a a eae 
i 4 (RP) i} Repro- } Changes the ; Changes the } O = no function! 
H } tect |} files current ;} read/write | requested | 
} | } read/write {| protection } 1 = change H 
H H | protection i keys of the H protection | 
| | i keys to new } communi- H keys { 
H | } protection | cations line } H 
} i | keys. i (SVC15) or | | 
| terminal 
H | | } (SVC1l) to new } H 
i | | } protection | H 
i i keys. 
H a a i a i a a ies na se ae ee ei i ns insincere “ae in ees ain | 
i} 5 (CL) } Close i} Closes an lu | Closes an lu {| O = no function} 
i | } assignment for {| assignment i requested | 
i { a particular i for a partic- {| 1 = close an lu} 
H i } device or } ular line H H 
j H } file. } driver or i H 
H | | |} terminal | H 
| Se SR Se a eS Seo ee ee re ee eer ee 
i 6 (DL) i Delete | Releases re- | Releases a | O = no function} 
H H {| served space | reserved LCB. |} requested jj} 
{ } } on a direct | {| 1 = release H 
{ | | access device. } i reserved { 
space 
{ i i in ei sis ec cw“ cs es “ees (Ges osc mc i a Sa em mi Te“ Sots eee en es | 
} 7 (CK) } Check- i Copies buf- | Copies buff- | O = no function! 
H } point. 1 fered file | ered file | requested | 
i | data toa - | Gata toa | 1 = copy H 
i | | direct access {| logical | buffered H 
| } } device. | terminal. H file data j} 
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i 

{ 

i BIT 

i POSITION } FUNCTION 
{ 

! 

i 8 | Access 
1 9 {| privi- 
i 10 | leges 
H H 

H 1 

H | 

H H 

i | 

H H 

H i 

H i 

H i 

H H 

1 | 

H H 

H i 

H ! 

| H 

H H 

H H 

H H 

1 H 

i i 

i] i 

t i] 

H H 

H H 

H H 

i H 

| H 

i H 

H H 

H H 

H 

ane a } Access 
{ 12 } method 
! H 

t | 

' 4 

H { 

| H 

1 H 

1 H 

1 H 

H H 

H | 

H H 

| | 

H 1 
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TABLE 7-1 SVC7 FUNCTION CODE BIT DEFINITIONS (Continued) 


a ts ae an ca es my at cae my Some se ee Aine cen ce Ge ee cements ee es ee ee ee ee ee ee ee ey ies cee ee ey ee ee ee ee 


DEVICE/F ILE 


Specifies a 
file's reading 
and writing 
restrictions. 


Specifies ver- 
tical forms 
control (VFC) 
for devices 
that support 
VFC. 


DATA 


COMMUN I CATION 


terminal's 


reading and 


writing 


restrictions. 


Indicates 


file access 


method for 


data commun- 


ications. 


BIT SETTING 


001 


010 


O11 


100 


101 


110 


111 


01 


10 
11 


with VFC 


read-only 
(SRO) 
exclusive 
read-only} 
(ERO) 
shared | 
wr ite- H 
only | 
(SWO) H 
exclusive} 
write- | 
only i 
(EWO ) H 
shared ! 
read/ H 
write i 
(SRW) H 
shared H 
| 
H 
| 
1 
i 
H 
| 
| 
1 
{ 
1 
| 


i] 
1 
t 
' 
! 
‘ 
! 
I 
! 
I 
! 
I 
! 
1 
! 
( 
] 
i 
4 


read, 
exclusive 
write 
(SREW) 
exclusive 
read, 
shared 
write 
(ERSW) 
exclusive 


terminal 
level 
(SVC1) 
access 
terminal 
level 
(SVC1) 
access 


reserved 
line 
level 
(SVC15) 
access 
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TABLE 7-1 SVC7 


FUNCTION CODE BIT DEFINITIONS (Continued) 


ee ces cre ee ee re re ee em ee cee me meee ee ee nme me renee ee em ee me ee ee ee me ee ee eee ee re ee re ee es ee ee ee ee ee ee ee eee eee ee 


BIT 
POSITION {| FUNCTION 


13 File 

14 types or 

15 software 
density 
selec- 
tion 
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MEAN ING 
i DATA 
DEVICE/FILE {| COMMUNICATION 
Indicates Indicates if 
file type or buffered 
mag tape terminal or 


density being 
used. 


line access 
is being 
used. 


BIT SETTING 


000 


ool 


010 


O11 


110 


100 


contig-— 


uous 


files or 


enable 
manual 


density 
selection 
on Telex 
mag tape 
drives; 
no action 
on other 
mag tape 


drives 


extend- 
able con- 


tigous 
files 


indexed 


files 


nonbuf f- 


ered 


indexed 


files 
long 
record 
files 
select 


800 bpi 
nonreturn 
to zero 
inverted 


(NRZ1) 


density 
(STC and 


Telex 
drives 
only) 
Select 


1600 bpi 


PE 


density 
(STC and 


Telex 
drives 
only) 


TABLE 7-1 SVC7 FUNCTION CODE BIT DEFINITIONS (Continued) 


Cee Ne et 


BIT 
POSITION 


13 
14 
15 
(Contin- 
ued ) 


X'oooo' 
attributes 


X'FF20' 


X'FFOO = re- 
turns time 
and date 
in system 
generation 
(sysgen) 
format 


FUNCTION 


Fetch 


date 


disk Di- 


ee ee ee ee oe ee ee ee ee ee ee es ee ee ee ee ee ee es oe = we 


| DATA 
DEVICE/F ILE | COMMUNICATION 


Returns the physical attri- 
butes of a file or device to 
the parameter block. 


Turns VFC on or off for de- 
vices that support VFC. 


Returns the time and date that 
the file was created and last 
written to. 


BIT SETTING 


110 = 


lil = 


on 
X'FF21' = VFC 


X'FFOL' 
turns time 
and date 
in ji 
mm/dd/yy ; 
hr:min:sec 
format 

X'FFO2' 
turns time 
and date 
in 
dd/mm/yy ; 
hr:min:sec 
format 


select 
6250 bpi 
group 
coded 
recording 
(GCR) 
density 
(STC and 
Telex 
drives 
only) 
commun i- 
cations 
buffered 
terminal 
manager 


= fetch 


= VFC 


off 


= re- 


= re- 
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TABLE 7-1 SVC7 FUNCTION CODE BIT DEFINITIONS (Continued) 


BIT 


| DATA H 
POSITION H 


FUNCTION {| DEVICE/FILE } COMMUNICATION {| BIT SETTING 


BRBRBBACECKBECCBEBSEEB SBASECBCEEECCETASTEBSASEECTEETBEBEBSEEETKCETRTSAEBVSTECBEVSESBATATAES 


i 
i 
i 
! ! 
{} O-15 H | {| X'FFO3' = re- | 
i (Contin- } H 1 turns time | 
} ued) H | | and date | 
H H | | in Julian | 
| | | | format H 
i H | {| X'FFO4' = re- | 
i H | H turns time | 
| H | i and date i 
{ H | H in direc- |} 
| H | H tory for- | 
i mat 
[See see sesaese= GeCag are) AES SARGERAS E oR eel 
} O-15 } Fetch } Returns current total logical {| X'FFOA' H 
H {| logical | records, current logical H | 
H } attri- { record position, index H | 
| | butes | blocksize and data H | 
H |} of open | blocksize. H H 
| file 


7.2.1.1 Allocate Function 

The allocate function makes a directory entry and reserves’ space 
on a direct access device for the file type specified in the 
modifier byte. The required parameter block fields for this 
function are: 

e Bits O and 13 through 15 of the function code 

@e Write key field 

@ Read key field 

@e Logical record length field 

@ Volume name field 

@ Filename field 

e Extension field 


e File class field 


e File size field 
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When a contiguous file is allocated, the file sectors are 
reserved, and the filename, sector starting address, read/write 
keys, file type and dates created and written are entered into 
the directory. A contiguous file is not buffered. When an 
indexed file is allocated, the filename, number of logical 
records, read/write keys, file type and dates created and written 
are entered into the directory. 


When an extendable contiguous file or nonbuffered indexed file is 
allocated, the file directory is set up as for an indexed file. 


When doing an allocation using a data _ communications terminal 
manager, two data buffers, each equal to the device physical 
block size, are reserved in memory for the _ LCB. The buffered 
terminal filename, logical record length, and read/write keys are 
entered into the LCB. See the OS/32 Basic Data Communications 
Reference Manual. 


7.2.1.2 Assign Function 
The assign function uses an lu to establish a logical connection 
between the task issuing the SVC7 and a file or device, and the 


communications line and buffered terminal. The required fields 
in the parameter block are: 


@e Bits 1 and 8 through 12 (and 13 through 15 for magnetic tape 
Grives) of the function code 
e lu 
@ Write key field* 
@e Read key field* 
e Volume name field 
e Filename field* 
@e Extension field* 
e File class field 
* Used for direct access devices 
When assigning to disk devices, the user-specified read/write 
keys corresponding to the specified access privileges are 
compared to the read/write keys in the file directory entry. If 
there is a match, the file is assigned according to the specified 
access privileges. If the access privileges are SWO or EWO and 
the user executes an assign function, the file is positioned at 
its logical end (append mode); otherwise, the file is positioned 


at the beginning. The access method 'O1' specifies the use of 
VFC. 
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When assigning to nondirect access devices, only the access 
privileges are examined. If the file is an indexed file, two 


data buffers and one indexed buffer are allocated in system space. 


when the file is assigned. Each data buffer equals the file data 
block size; the index buffer equals the file index block size. 
If the file is an extendable. contiguous file or nonbuffered 
indexed file, one index buffer is allocated in system space when 
the file is assigned. 


y ee ey ee Temporary File Allocation and Assignment Function 


The allocation and assignment functions can also reserve space 
temporarily on a direct access device for the file type specified 
in the modifier byte. Such a file is temporary because it exists 
only while the file is assigned to an lu and is deleted when the 
file is closed. The required parameter block fields for this 
function are: 


e Bits O, 1, 8 through 10, and 13 through 15 of the _ function 
code field 


e lu field 
@e Logical record length field 


e File size field 


To allocate a temporary file, specify an allocate or assign 
function and am ampersand (&) as_ the first character of the 
filename. When the temporary file is allocated, a directory 
entry is made for the filename and the file is placed by default 
on the temporary volume. The temporary file is then assigned to 
the lu specified in the parameter block. A temporary file also 
can be allocated and assigned from the system console through the 
operator TEMPFILE command. See the 0OS/32 Operator Reference 
Manual. 


7.2.1.3 Change Access Privileges Function 


The change access privileges function changes the current access 
privileges of an assigned file or device to the access privileges 
specified in the parameter block. The new access privileges must 
be compatible with the existing ones; otherwise, the change in 
access privileges would result in increased access. For example, 
to change SRO to SRW, the appropriate protection key must. be 
supplied. The required parameter block fields for this function 
are: 


@ Bits 2 and 8 through 10 of the function code field 


e lu field 
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@e Write key field 


@ Read key field 


7.2.1.4 Rename Function 
The rename function causes the filename and extension identifiers 
currently in effect to be changed to the filename and extension 
identifiers specified in the parameter block. The file must be 
currently assigned to the specified lu with ERW access privileges 
and exist on a direct access storage device (DASD). The required 
parameter block fields for this function are: 
e Bit 3 of the function code field 
® lu field 
e Filename field 
e Extension field 
e File class/account field 
When executing the rename function, the parameter block volume 
name is ignored, and the specified filename and extension replace 
the current filename and extension in the device directory. 
NOTE 

An e-task is allowed to rename a device. 

See the 0S/32 System Level Programmer 

Reference Manual for more information. 
7.2.1.5 Reprotect Function 
The reprotect function changes the read/write protection keys of 
a currently assigned file to the contents of the read and write 
key fields. The file must be on a direct access device and 
assigned to the specified lu with access privileges. The 
required parameter block fields are: 


e Bit 4 of the function code field 
e lu field 


@ Write key field 


e Read key field 
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When executing the reprotect function, the specified read/write 
keys replace the current read/write keys of a specified file in 
the device directory. 
NOTE 
An e-task is allowed to reprotect a 
device. See the OS/32 System Level 
Programmer Reference Manual for more 
information. 
7.2.1.6 Close Function 
The close function breaks the logical connection between the task 
and file or between the device or a data communication line and 
terminal by closing the currently assigned lu. The parameter 
block's required fields are: 
e Bit 5 of the function code field 
e lu field 
When the lu is closed, all data in system buffers or terminal 
buffers are copied to the user file. 
7.2.1.7 Delete Function 
The delete function removes the file directory entry and releases 
the reserved space of a currently unassigned file on a direct 
-access device. When deleting through the communications buffered 
terminal manager, a currently unassigned LCB is removed from 
memory. The required parameter block fields are: 
@e Bit 6 of the function code field 
@ Write key field 
@e Read key field 
@ Volume name field 
@e Filename field 


@ Extension field 


@e File class/account field 
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If the contents of the parameter block volume name, filename, 
extension and read/write keys fields match the fields in the file 
directory entry, the file is deleted. If the logical terminal 
name matches the name in the LCB, the LCB is deleted. 


7.2.1.8 Checkpoint Function 


The checkpoint function copies the buffered file data to the 
indexed file or the buffered terminal data to the terminal and 
updates the directory entries. Executing a checkpoint function 
on a nonbuffered indexed file or extendable contiguous file 
updates the directory entries for the file. Executing a 
checkpoint function on a contiguous nondirect access device or 
unbuffered file has the same effect as an SVCl wait-only call. 
The required parameter block fields for this function are: 


e Bit 7 of the function code field (bits 11 and 12 for data 
communications ) | 


e lu field 


After executing a checkpoint function, the file pointer is not 
repositioned to the beginning of the file as in a close function. 
If a system failure occurs and data exists in the file buffers, 
all data up to the last close or checkpoint function is 
recoverable; any data appended after the last close or checkpoint 
function is lost. Therefore, to prevent loss of data, use the 
checkpoint function frequently, especially after a large amount 
of data or any important data has been written to a buffered 
file. 


7.2.1.9 Fetch Attributes Function 


The fetch attributes function sends to the SVC7 parameter block 
the physical attributes of the file or device currently assigned 
to the specified lu. These attributes include the device 
mnemonic or volume name, filename, extension, file class and file 
size, which are sent to their respective fields in the SVC7 
parameter block. Device codes are sent to the modifier byte of 
the function code field. Device attributes are stored in the 
write and read key fields. The logical record length field can 
receive either a file logical record length or a device physical 
record length. These field differences for the fetch attributes 
function are illustrated in Figure 7-3. 
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So) oe Sen see eee Som SED Ce GD SE Se OOS ies Ee OD Gree Gee ER eee eens ete come cme seme cous aoe eee ieee ome mes Ge see mee ee mee me ee ee ce ee mee ee ee ee ee ee ee en ee ee ee ee ee 


10(0) }1(1) 12(2) 13(3) | 
{ Command byte {| Device codes {| Error status | lu i 
| | | 
ine tnpanccee wea paSeee See ees Aaa ee en Tama te aaa sseaesSae | 


14(4) 16 ( 
Device attributes | 
| 


6) | 
Physical record length | 

! 

! 


cn ee ND ES AS SS RS SNS ES SEN SS (SS SE GENS RS iD SD Sy GS OR GD Oe AR SE SS sone ELS Ge SE SD Oe ene cme ame MEE Ge GEE Wane Oey CORE GED GE ee Ge mee me Ge ES Se: Me Goes Gm ames mene fe Gr 


18(8) 
H Volume name or device mnemonic | 
a aa ac el cc a aa a rca a a a a he 
}12(C) 
| . 
 oeteatontentententeatentaates Filename Freee H 
{16(10) H 
| esa ei Yom eas ‘ese Snel i ch ca ccs “nn Ss Ss nS wi Ses “encase ais‘ “am “cc em i ar’ cv seen ‘ins (mes “sans SS | 
120(14) 123(17) | 
Extension i File class | 
i t 
Re ee eee eee eee E Eee T ee a Se renee 7 
124(18) 
| File size | 
Svc 7,parblk 
ALIGN 4 
parblk DB 0,0 
DS 1 
DB lu 


DS 24 bytes for device attributes 


Figure 7-3 SVC7 Parameter Block Format and Coding 
for a Fetch Attributes Function 


When executing this function, the device codes field receives a 
hexadecimal number indicating the file or device type. The 0S/32 
System Generation 132 (Sysgen/32) Reference Manual lists all the 
devices and their device codes. The command byte, error’ status 
and lu fields are the same as those defined in Section 7.2. 


The device attributes field receives a hexadecimal number 


indicating certain file or device attributes. Table 7-2 lists 
all supported attributes and corresponding masks. 
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TABLE 7-2 DESCRIPTION AND MASK VALUES OF THE DEVICE 


ATTRIBUTES FIELD 


| BIT | 

| POSITION | MASK 
| 0 | X'8000' 
1 | X'4000' 
! 2 | x'2000' 
! 3 | x'1000' 
! 4 | x'0800' 
| 5 ! X'0400' 
| 6 1 x'0200" 
! 7 ! X'0100' 
| | 

8 | X'0080' 
| 9 | x'0040' 
1 10 1 x'0020! 
! 11 | X'0010' 
! 12 ! x'0008' 
| 13 | x'0004' 
| 14 | x'0002' 
1 15 : x'0001" 


* Indicates 


The physical record length field 

physical 
assigned to the specified lu; 
and 120- or 


length of the 


readers 


ATTRIBUTES 


Interactive device 


Supports read* 


Supports 
Supports 
Supports 
Supports 
Supports 


Supports 
extended 


Supports 
Supports 
Supports 
Supports 
Supports 
Supports 


Supports 


wr ite* 

binary 

wait I/0 

random access 
unconditional proceed 


image mode and 
options 


halt 1/0 

rewind 

backspace record 
forwardspace record 


write filemark 


forward space filemark 


backspace filemark 


Device-dependent function 


the current access privilege 


file 


or 


e.g. 


device has variable length records, 


this field; e.g., magnetic tape. 


receives 


the logical 


80-byte 


devices are normally used as fixed record length devices. 
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record 
record length of the device 
record for 
132-byte record for line printers. 
a value of O is 
However, variable length record 


If the 
returned to 


For direct access devices, contiguous and extendable contiguous 
files may be treated as having either a sector-length record size 
(256 bytes) or a variable length record. Indexed and nonbuffered . 
indexed files have a fixed record length, which is the file's 
logical record length established at allocation time. 


The direct access device volume name, filename, extension and 
file class are sent to their corresponding fields in the 
parameter block. For a nondirect access device, the device 
mnemonic is sent to the volume name field, and the filename, 
extension and file class fields of the parameter block are filled 
with blanks. 


For direct access devices, the file size field receives an 
unsigned hexadecimal number indicating the current size of a 
direct access file. For indexed and nonbuffered indexed files, 
this field contains the number of logical records in the file. 
For contiguous or extendable contiguous files, this field 
contains the number of sectors in the file. 


For bare disk devices, the first two bytes of the file size field 
contain the controller device address if the bare disk is 
attached to a controller. If the bare disk is not attached toa 
controller, the first two bytes equal zero. The remaining two 
bytes of this field contain the selector channel (SELCH) device 
address if the disk is accessed via a SELCH device; otherwise, 
this 2-byte field contains a zero. 


ee ee Se ee Se ee wee Ge eee ee cee come wD ee ee ee ee ee ee ee ae ee ee ee Re ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee eee ee 


{24(18) }26(1A) 
|} Controller device address | SELCH device address 


After executing a fetch attributes call, the file size field 
receives the current size of a file on a direct access device. 
Tne file size field is not used for nondirect access devices. 


7.2.1.10 Vertical Forms Control] (VFC) Function 
The VFC option turns the VFC function on or off for a particular 


device. To execute this function, only the first four bytes of 
the SVC7 parameter block are required as shown in Figure 7-4. 
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1(1) 12(2) 


az 
: 
» 
| 
Qo, 
a 
< 
cr 
@ 
4 
OQ 
oO 
-- 
rh 
- 
@ 
Ki 
83] 
Le | 
Rn 
‘@] 
Kr 
ce] 
ct 
» 
ct 
ow 
@ 
~ 
c 


byte H 


parblk ALIGN 4 


DB X'FF' 

DB X'20' or ‘'21' 
DS 1 

DB lu 


Figure 7-4 SVC7 Parameter Block Format and Coding 
for VFC Function 


This parameter block must be fullword boundary-aligned and 
located in a task-writable segment. 


To turn on the use of the VFC function for a particular device, 
set the modifier byte to X'20'. To turn the function off, set 
the modifier byte to X'21'. The error status and lu fields are. 
the same as for all SVC7 services. 


7.2.1.11 Fetch Time and Date Attributes from Disk Directory 
Function 


The fetch time and date attributes function returns to the SVC7 
parameter block the date and time the disk file was created and 
last written to. 


FUNCTION 
CODE FORMAT 

X'FFOO' Defined during sysgen 
X'FFOL' Month/day/year 

hours :minutes:seconds 
X'FFO2 Day/month/year 

hours :minutes:seconds 
X'FFO3' Julian 
X'FFO4' Directory 


The parameter block fields for receiving the first three options 
are shown in Figure 7-5. Sysgen can define either format 
designated by function code X'FFOL1' or X'FFO2'. 
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0(0) 11(1) 12(2) 13(3) 
Command byte | Modifier byte | Error status | lu 
| 

4(4) 
SSeS sae Created date SSSR Seaae 
8(8) 
12(C) 
cee aaies asi Alea Sele Created time 0 rrr rr 
16(10) 
20(14) 
SSS Ses aaa Last written date selon an ara aL 
24(18) 
28(1C) 
ee ee Last written time a ar a 
32(20) . 

SVC 7,parblk 

parblk DB X'FF! 

DB X'On' n=0,1, or 2 

DS 1 

DB lu 


DS 8 bytes for created date 
DS 8 bytes for created time 
DS 8 bytes for last written date 
DS 8 bytes for last written time 


Figure 7-5 SVC7 X'FFOO', X'FFO1' or X'FFO2' Parameter 
Block Format and Coding for Fetch Time and 
Date Attributes Function 
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The SVC7 parameter block fields for receiving the Julian format 
are shown in Figure 7-6. The date is represented by a five-digit 
number . The first two digits indicate the year; the last three 
digits indicate the number of days since January 1. The time is 
the number of minutes since midnight. Both the date and time are 
returned as binary numbers. 


10(0) f1¢1) 12(2) 13(3) 
| Command byte {| Modifier byte | Error status | lu | 
| | 
finn nnn nnn nn nnn nnn nnn neem nes nnn nea ennn | 
14(4) 
Created date 1 
ae a aa aa a aaa 
18(8) ! 
i Created time \ 
t { 
Fi ace es ag Se ee ! 
}12(C) 
i Last written date H 
{ { 
LL La TO RE ee TaN : 
{16(10) 

i 


c 
© 
ti] 
ct 
= 
im 
}~- 
(Tr 
cr 
YY) 
re 
cr 
- 
= | 
ra) 


svc 7,parblk 


parblk DB X'FF' 


DB X'0O3' 

DS 1 

DB lu 

DS 4 bytes for created date 

DS 4 bytes for created time 

DS 4 bytes for last written date 
DS 4 bytes for last written time 


Figure 7-6 SVC7 X'FFO3' Parameter Block Format and Coding 
for Fetch Time and Date Attributes Function 


The SVC7 parameter block fields for receiving the dates and times 
exactly as they appear in the directory are shown in Figure 7-7. 
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0) 11(1) 
| Modifier byte } 
{ 


Qa 
: 
> 
sae 
Q 
ox 
“< 
(T 
@ 
05 ee 
Le | 
Kt 
o 
Ky 
6} 
cr 
» 
cr 
G 
4) 
_ 
c 


svc 7,parblk 


parblk DB X'FF'! 


DB x'04' 

DS 1 

DB lu 

DS 4 bytes for created date and time 


DS 4 bytes for last written date and time 


Figure 7-7 SVC7 X'FFO4' Parameter Block Format and Coding for 
Fetch Time and Date Attributes Function 


7.2.1.12 Fetch Logical Attributes of Open File Function 


The fetch logical attributes of open file function returns. the 
following attributes for an open file to the SVC7 parameter 
block: 


e Total logical records currently in the file 


@e Current logical record position if the file is accessed 
sequentially 


e Index blocksize of indexed nonbuffered indexed and extendable 
contiguous open files 


@® Data blocksize of indexed nonbuffered indexed and extendable 
contiguous open files 
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The function code for this SVC7 is X'FFOA. Figure 7-8 shows’ the 
SVC7 parameter block fields for receiving the logical attributes 
of an open file. 


10(0) i1(1) }2(2) 13(3) 
;} Command byte | Modifier byte | Error status | lu H 
i] { { ] 

ee a he ee a : 
14(4) , l 
Total logical records 
( J 
J ' 
|G ie alicia ata aii are ae ates ae a eee ee ae eas | 
18(8) | 
i Current logical records | 
{ ' 
a ae : 
112(C) 14(E) 


oO 
1) 
cr 
1) 
joy 
Es, 
.e) 
Q 
al 
Q 
p- 
N 
@ 


parblk DB X'FF! 


DB X'OA' 

DS 1 

DB lu 

DS 4 bytes for total records 

DS 4 bytes for current logical record 
DS 2 bytes for index blocksize 

DS 2 bytes for data blocksize 


Figure 7-8 SVC7 X'FFOA' Parameter Block Format and Coding for 
the Fetch Logical Attributes of Open File Function 


7.2.1.13 Spoolfile Assign to Pseudo Device Function 


The spoolfile assign to pseudo device function will enable the 
user to specify such things as preprinted forms, number of copies 
to be output, output priority, image or formatted I/O, multiple 
assignments to the same spoolfile and specification of data-index 
block sizes for the spoolfile. Additionally, the printing of a 
spoolfile can be delayed until its output is requested. 


This spoolfile assign is intercepted by SPL/32, which is solely 
responsible for its handling. If the SPL/32 fails to intercept 
this SVC7, an error will result (error code xX 'D': SPL/32 
inactive). 
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' 00(00) ~ | 02(02) ! 
| Function code = X'FF40' } Error status } lu H 
Assign spoolfile 

{ 


| 04(04) } 05(05) | .06(06) 
| Previously | Number of | Logical record length 
{ assigned lu {| copies | 
[Seo he eee Sa SSeS SSeS SSeS SSeS aS Heese eer Sear Sa i 
{ 08(08) 
| Pseudo device H 
| 
Pree See eee se = eee er ae eee ee eee 
{ 12(00) 
{ Forms file | 
[joo S ee = (fidjename) 9 ‘@se>seceer= 
} 16(10) preprinted form name 
page e Sera e SS oa eee eee on ae ee ee eee ene 
} 20(14) | 23(17) 
{ Forms file extension | Forms file | 
| (RO1 only) | account(ROl) | 
| mr nn enn nn nnn nnn nner nner n 
| 24(18) | | 
| Index block size | Data block size 
| se es a Sa a ce a a a a a a es aes tae sg i eae i 
| 28(10) 
{ Forms file volume 1 
{ (ROL only) 
| ee a ses a ce are ee te ee me cme ca ED me oo ce em Dee cee SD we 2m ee me ee eee ee TD mr me es SUD ONTO cee GE ee cee ne cere aD oo meee me | 
| 32(20) | | 32 (22) { 35(23) 
| Options ;} Priority {| Reserved | 
i | 


Figure 7-9 SVC7 Spoolfile Assign to Pseudo Device 
Parameter Block 


The l-byte error status field receives the appropriate error code 
from SPL/32 when an error occurs while servicing an SVC7. If no 
error occurs, the error status field contains zeros. For error 
codes returned by SPL/32, see Table 7-6. 
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7.2.1.14 Extended Assign to Spoolfile Function 


If multi-terminal monitor (MTM) is doing an assign on behalf of 
a task, it assigns the lu to itself, then sends the lu to the 
task. If the assign is intercepted, the information retrieved 
via the PEEK option 3 is about MTM and not the expected task. 
For this reason, an extended spoolfile assign has been created. 


ee eed 


; 00(00) i 02(02) } 03(03) i 
i Function code = X'FF41' { Error status | lu H 
i Extended assign spoolfile | H i 
a a a a aa a eh ee a 
i 04(04) t 05(05) | 06(06) 1 
i Previously {| Number of H LRECL H 
i assigned lu | copies H (Logical record length) t 
POSES he ee ee ee ee a ee 7 
} 08(03) 
\ Pseudo device i 
t ! 
fae et Pe ees | 
} 12(00) 
i i 
H Forms file H 
 aietaseytadenesasanetes (filename) 202 2 2 2 9 --486RRFRHH= H 
{ 16(10) preprinted form name H 
i] t 
! 
nen non a ca ela a ld i 
i 20(14) } 23(17) { 
H Forms file extension { Forms file H 
i (RO1 only) } account(RO1) | 
ns a aaa ac a iat | 
i 24(18) i | 
| Index block size H Data block size H 

t t 
(ee SE een a aa ae dae ce | 
{ 28(10) 
! Forms file volume | 
i (RO1 only) | 
a a aaa a a a ie ear t 
i 32(20) |} 34(22) | 35(23) i 
H Options } Priority { Reserved H 
‘ t i | 
Fa hte GaSe I AGS ee eae ee 
| 36(24)) 
i | 
i i 
[sSsSSsSsSs=> U-task name 0 wr rer rrr H 
i} 40(28) 
i i 
i i 
a a a a a a a a a | 
i 44(20) i 
| 
pesseessass5 Origin identifier 9 ~----4--"--- i 
{| 48(30) (OID) i 
' i 
(ee aS SS ae See pa aa see ese eer eres Some te a See i 
i 52(34) 
i 
{ i 
[=SscSs=-s<+= Authority Identifier 4 4 42229 ----------- H 

56(38) (A 


Figure 7-10 Extended Spoolfile Assign Parameter Block 
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Fields: 


U-task name is the name of the u-task for which the assign 
is being performed. 


OID is the origin identifier. The OID is used to 
determine the default print location for those 
devices or tasks associated with a group. 


AID is the authority identifier. The AID is’ used 
by SPL/32 to identify if an origin location 
has authority to perform the requested 
function. 


Priority is the current priority of the task requesting 
the assign. 


7.2.1.15 Assign to Pseudo Device Function 


In order to utilize spooling from the task level, the user _ can 
issue an SVC7 assignment (function code bit 1) for a pseudo 
device. The spooler will intercept the SVC7 assign and will 
process it. 


The task's monitor name, priority and task name will be available 
through the PEEK option 3. If the task is running under. the 
control of MTM, its AID and OID will be available as the 
originating user console device; otherwise this field will 
contains zeros. Any u-task that uses this standard SVC7 assign 
to a spooler pseudo device will continue to function without 
modification. 


7.2.1.16 Access Privileges 

This 3-bit modifier field contains the access privileges 
indicating the file's current reading and writing restrictions 
and is required for these functions: 

® Assign 

® Change access privilege 

@ Rename 

e Reprotect 

Access privileges allow other tasks to access an assigned file or 
prevent such access. Table 7-3 lists access privileges and their 
meanings that are established when the file is assigned and 
subsequently changed through the change access privilege 


function. The rename and reprotect functions require the file to 
have an assigned ERW access privilege before executing. 
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TABLE 7-3 ACCESS PRIVILEGE DEFINITIONS 


—— a Se Se ae eS ee ee ee ee es ee eS Se ee ee ee es ee ee ee ee ee ee ee ee ee ee ee ee ee oe ee ee ee ee es ee ee es ee ee ee em ee ee ee ee oe oes ee en ee eee 


ACCESS 
PRIVILEGE 


SRO 


MEAN ING 


This task can read from the 
assigned file but cannot write 
to it. Other tasks can read 
from and write to the assigned 
file. 


H BIT 
| SETTING 


{| O0O=SRO 


This task can read from the 
assigned file but cannot write 
to it. Other tasks can write 
to but cannot read from the 
assigned file. 


This task can write to the 
assigned file but cannot read 
from it. Other tasks can read 
from and write to the assigned 
file. 


This task can write to the 
assigned file but cannot read 
from it. Other tasks can read 
from but cannot write to the 
assigned file. 


Tasks can read from and write 
to the assigned file. This is 
the default. 


This task can read from and 
write to the assigned file. 
Other tasks can read from but 
cannot write to the assigned 
file. 


This task can read from and 
write to the assigned file. 
Other tasks can write to but 
cannot read from the assigned 
file. 


This task can read from and 
write to the assigned file. 
Other tasks cannot read from 
or write to the assigned file. 
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7.2.1.17 Change Terminal Mode 


This SVC7 is used to change the access method of a Model 3270. 
drop without eliminating and regenerating a Model 3270 support 
LCB. This extended SVC7 allows a task to switch between Model 
3270 Pass Thru and Model 1200 Emulation, and/or change the read 
method between read immediate modified and read immediate 
unprotected as the application requires. The format is similar 
to other extended SVC7 parameter blocks with the exception of the 
following settings in the function code. 


FUNCTION 
CODE EXTENDED SVC7 FUNCTIONS 

X'FF30' Model 1200 terminal emulation read immediate 
unprotected 

X'FF31' Model 3270 rerminal pass thru read _ immediate 
unprotected 

X'FF32' Model 1200 terminal emulation read immediate 
modified 

X'FF33' Model 3270 terminal pass thru read immediate 
modified 


7.2.1.18 Data Communications Access Methods 
This 2-bit modifier field contains the access methods used by 


Gata communications. The access methods are listed in Table 7-4. 
See the OS/32 Basic Data Communications Reference Manual. 
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TABLE 7-4 DATA COMMUNICATIONS ACCESS METHOD DEFINITIONS 


DATA 
COMMUNICATIONS | 
ACCESS METHOD | MEAN ING | BIT SETTING 


Terminal level | This device-independent support {| 00 = ter- 


1 

i access } of a communications terminal | minal 

{ {| through the data communications | level 

i } terminal manager is in both access 

| | buffered and unbuffered mode. {| Ol = ter- 

| This is accomplished through i minal 

H | SVCl. { level 

access 

i | with 

i VFC 
Line level This is the device-dependent | 11 = line 
access support of a communications level 


cations driver. This is accom 
plished through SVC15. 


} line through the data communi- | access 
{ 1 
! ! 


7.2.1.19 File Types 

This 3-bit modifier field contains file types used and required 
by the allocate function. The file types are: 

@e Contiguous files 

@ Extendable contiguous files 

@e Indexed files 

e Nonbuffered indexed files 

@e Long record files 

@e Data communications buffered terminal manager 

The file type field is also used to select the density of write 
operations to a magnetic tape drive. This selection is made when 
the magnetic tape driver is assigned to an lu through the SVC7 


assign function. The software density selections available to 
the assign function are described below. 
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BIT 


SETTING DENSITY SELECTION 
000 Manual density (Telex drives only) 
100 800 bits per inch (bpi) NRZI density (STC and 
Telex drives only) 
101 1600 bpi PE density (STC and Telex drives only) 
110 6250 bpi GCR density (STC and Telex drives only) 


For STC and Telex drives, neither software density selection nor 
manual density selection has any effect on read operations. The 
tape is always read at the density at which it was recorded. 


For drives that require software enabling of manual density 
selection (i.e., Telex drives), a value of zero should be placed 
in the file type field if manual density selection is desired. 
For drives that require manual enabling of software density 
selection (i.e., STC), software select should be enabled. on the 
operator panel before the first output operation is attempted. 
Otherwise, the tape is written at the manually selected density. 
In addition, if the magnetic tape drive does not support software 
selection of density and the file type field does not contain 
zero, the drive is not assigned and status code X'09' is returned 
in the SVC7 parameter block. 


7.2.1.20 Read/Write Key Fields (SVC7.RKY/SVC7.WKY) 


The read/write key fields should contain the hexadecimal number 
indicating the file or device read/write protection keys 
established at allocation time. When a task is assigned to a 
file or device through an lu, the read/write protection keys 
specified at assign time are compared to the keys established at 
allocation time for a match. If they match, the condition is 
met, and the task can be assigned for the protected access mode 
(conditionally protected). Files and devices can be unprotected, 
allowing any key specified at assign time to be accepted. Files 
and devices can also be unconditionally protected, causing 
rejection of any keys specified at assign time. Table 7-5 lists 
the read/write protection keys. 
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TABLE 7-5 READ/WRITE PROTECTION KEYS DEFINITIONS 


KEYS MEANING 


| 
00 { Unconditionally unprotected; the file or i 
{| device is unprotected for the specified i 
{ access mode (read or write). Any key { 
{| specified at assign time is accepted. If no | 
| keys are specified, this key is the default. j 


{| Conditionally protected; the file or device | 
{| is protected for the specified access mode | 
{| (read or write). Matching keys must be | 
| specified at assign time to gain access to i 
| the device or file. { 


{ Unconditionally protected; the file or device } 
{| is protected for the specified access mode | 
| (read or write). No u-task can assign for | 
{| protected access mode. | 


7.2.1.21 File Size Field (SVC7.SIZ) 


The file size field must contain a hexadecimal number’ indicating 
the file size established at allocation time on a direct access 
device. For contiguous files, this field must contain the number 
of sectors in the file. 


z 
: 
© 
Hy 
e) 
Ph 
a 
® 
oO 
ct 
fe) 
as 
a 


For indexed, nonbuffered indexed and extendable contiguous files, 
the first two bytes of the file size field must contain the index 
block size in increments of sectors (256 bytes); the remaining 
two bytes of the file size field must contain the data block size 
in increments of sectors. If zeros are specified for index block 
size or data block size, the file is allocated to the system 
default appropriate for that particular parameter. 


124(18) Index block size {26(1A) Data block size | 
(sectors) | (sectors) 
(SVC7.1SZ) | (SVC7 .DSZ) { 
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For data communications buffered terminals, this field must 
contain the physical block size in bytes. 


{}24(18) 

| Physical block size (bytes) 
| 

{ 


For bare disk devices, the first two bytes of the file size field 
contain the controller device address if the bare disk is 
attached to a controller. If the bare disk is not attached to a 
controller, the first two bytes equal zero. The remaining two 
bytes of this field contain the SELCH device address if the disk 
runs from a SELCH device; otherwise, this 2-byte field contains 
a zero. 


{24(18) {26(1A) 
{| Controller device address |} SELCH device address 


After executing a fetch attributes call, this field receives the 
current size of a file on a direct access device. This field is 
not used for nondirect access devices. 

7.3 SVC7: EXTENDED FUNCTIONS FOR PRIVILEGED TASKS 

The OS/32 file manager provides additional resource management 
services to privileged tasks. These services are accessed 
through the extended function codes of SVC7. These functions 
include: 

@e bare disk assignment, 

e fetch attributes for bare disk devices, 

@e device rename and reprotect, and 

@ extended close. 


The following sections describe how to access the SVC7 extended 
functions for privileged tasks. 
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7.3.1 SVC7: Bare Disk Assignment 


An e-task, privileged u-task or diagnostic task (d-task) with 
bare disk privileges can bypass the file manager and directly 
assign to a disk device. When such a task issues an SVCl_ I/O 
request directly to a disk device, the operation is referred to 
as bare disk I/0 and should always be random access. The 
supported I/O functions are read, write and test and set. 


Direct assignment to a disk device can be performed only by a 
task that has the bare disk task option enabled. E-tasks always 
have this option enabled. A u-task or d-task is given bare disk 
privileges by specifying the disk privilege option in the OPTION 
command (OPTION DISC) when the task is built by Link. However, 
if the task loader has the e-task option prevented, the 
privileged task is loaded into memory with the bare disk 
privilege option changed to the default, no bare disk privilege. 
Therefore, bare disk I/O cannot be performed by the task. 


The SVC7 parameter block and coding for bare disk assignments are 
shown in Figure 7-11. 
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10(0) {12(2) Error 13(3) 
Function code | status code | lu 
} (SVC7.OPT) | (SVC7.STA) t (SVC7.LU) 
} Sst asics" i'n a ins “tans S05 Yad re-set “tam hem «lg Aust“ cee lw een "Saw mes mesa meh“ Vcc ape Senses wv aso? em <email oc sec mcs 
14(4) 
| Reserved 
(SVC7 .WKY) 
i a aS nae eee a sae ms sas Ae es ine “es, en “ns ce Vc “cs me ca Vesa aa cues ee io See“ wesc es ees ce 
18(8) 
H Device mnemonic 
H (SVC7.VOL) 
H Se tn sm: me ci” hse “i'r snp’ yn Ve "enemies wasn ‘gyn nS “iin ect ine ‘eS fa ‘ales acs lw es est ne acts cas es ee 
1 12(C) 
i 
| ee acai a 
{16(10) Reserved 
H (SVC7.FNM) 
i] 
Meee er 
124(18) 
1 
i} 
SVC 7,parblk 
ALIGN 4 
parblk DC X'function code' 
DB 0 
DB lu 
DC 0 
DC C'4-character device mnemonic' 


DC 0,0,0,0 


Figure 7-11 SVC7 Bare Disk Assignment Parameter Block 
- Format and Coding 


This parameter block must be 28 bytes long, fullword 


boundary-aligned and located in a task-writable segment. 
description of each field in the parameter block follows. 
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A 


mas anne wa ae ae ee ee ee ee ee 


Fields: 


Function 
code 
(SVC7.OPT) 


Error 
status 
codes 
(SVC7.STA) 


lu 
(SVC7.LU) 


Reserved 
(SVC7.WKY ) 


Device 
mnemonic 
(SVC7.VOL) 


Reserved 
(SVC7 . FNM) 


is a 2-byte field that contains the 
hexadecimal number indicating the assign 
function (bit 1 must be set). In addition, 
the appropriate access privileges (bits 8 
through 10) must be set as follows: 


e 000 = SRO 
e 001 = ERO 
e 010 = SWO 
e 011 = EWO 
e 100 = SRW 
e 101 = SREW 


e 110 = ERSW 


e 111 = ERW 


CAUTION 


IF THE BARE DISK IS MARKED 
ON-LINE, ONLY ASSIGNMENTS FOR’ SRO 
ARE ALLOWED. ANY OTHER ACCESS 
PRIVILEGE IS REJECTED, AND A 
PRIVILEGE ERROR STATUS (07) IS 
GIVEN. 


is a l-byte field that receives an error code 
when an error occurs during SVC7 execution 
If mo error occurs, a value of O is returned 
to this field. See Table 7-6 for a list of 
SVC7 error codes. 


is a l-byte field that contains a hexadecimal 
number indicating the logical unit to be 
assigned to the bare disk device. 


is a 4-byte reserved field that must contain 
a zero. 


is a 4-byte field containing the device 
mnemonic of the bare disk device. 


is a 16-byte field that must be reserved with 
zeros. 
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7.3.2 SVC7 Code 0: 


Fetch Attributes 


The fetch attributes function fetches the attributes of 


Gisk device 
reset in the 


through its 
attributes 


parameter block if the disk is marked on protected. 


This SVC7 function is available only to 
Before issuing this SVC, the task must 
have the bare disk already assigned to the lu. 


privileges or to e-tasks. 


the parameter block format and coding for SVC7 code 0. 


for Bare Disk Devices 


bare. 

assigned lu. The write attribute is 
halfword field (SVC7.ATRB) the 
tasks with bare disk 


Figure 7-12 shows 


0(0) 
Option code 


1(1) 


Device code 


— me mee ese eee ee es ee ee ee ee ee ee ee ee eee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee 


22(16) 
Sectors per track 


4(4) 
Attributes 
18(8) 
i 
H 
12(C) 
16(10) 
120(14) 
H Tracks per cylinder 
{ 
! 
124(18) 
H Controller address 
t 
{ 
Svc 7,parablk 
ALIGN 4 
parblk DB 0 
DS 2 
DB lu 
DS 24 


Figure 7-12 
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SVC7 Code 0 Parameter Block Format and Coding 


parameter 
boundary-aligned and located in a task-writable segment. A 
general description of each field in the parameter block follows. 


Fields: 


Option 


Device code 


Status 


lu 


Attributes 


Device number 


Volume 
Flags 

Size 
Tracks per 


cylinder 


Sectors per 
track 


Controller 
address 


SELCH 
address 


block must be 28 bytes long, fullword 


is a l-byte field that must contain xX'00' to 
indicate the fetch attributes function. 


is a l-byte field that receives the device 
code of the bare disk device. 


is a l-byte field that receives the return 
status of the bare disk device. 


is a l-byte field that must contain the 
logical unit for which attributes are 
returned. . 


is a 2-byte field that receives the attributes 
of the bare disk device. 


is a 2-byte field that receives the device 
address of the bare disk. 


is a 4-byte field that receives the device 
mnemonic for the bare disk. 


is a 4-byte field that receives the device 
flags for the bare disk. 


is a 4-byte field that receives the number of 
sectors on the bare disk. 


is a 2-byte field that receives the number of 
tracks per cylinder on the bare disk. 


is a 2-byte field that receives the number of 
sectors per track on the bare disk. 


is a 2-byte field that receives the controller 
address for the bare disk device. 


is a 2-byte field that receives the selector 
channel address for the bare disk device. 
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7.3.3 SVC7: Device Rename 


E-tasks can use the SVC7 rename function to rename devices. The 


e-task must have the device already assigned to the lu with ERW 


access privileges. 


The SVC7 parameter block format and coding for 


is shown is Figure 7-13. 


renaming devices 


{0(0) }2(2) Error 13(3) t 
} Function code | status code | lu t 
H (SVC7.OPT) | (SVC7.STA) (SVC7.LU) t 
lpia oa a ee ee | 
14(4) | 
H Reserved | 
H (SVC7 .WKY ) t 
[arc Senn Stina iaiaie ried seta ae inosine a ego es aa a | 
18(8) | 
{ Device mnemonic | 
t (SVC7.VOL) } 
expen se une A er eo Ae eae | 
112(C) | 
| | 
ee Cl (‘é‘O‘OCO#OC#O*O*;*;C*#CRRESEE® | 
416(10) Reserved L 
(SVC7.FNM) 

Vann ee a 
i24(18) 
H 

Svc 7,parblk 

ALIGN 4 

parblk DC x'1000' 

DB 0 

DB lu 

DC 0 

DC C'4-character device mnemonic' 

DB 0,0,0,0 

Figure 7-13 SVC7 Device Rename Parameter Block 
Format and Coding 
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This parameter block must be 28 bytes long, fullword 
boundary-aligned, and located in a task-writable segment. A 
description of each field in the parameter block follows. 
Fields: 
Function is a 2-byte field that contains the 
code hexadecimal number X'1000' indicating that the 
(SVC7.OPT) rename function is to be performed. 
Error is a l-byte field that receives an error code 
status when an error occurs) during SVC7 execution. 
codes If no error occurs, a value of 0 is returned 
(SVC7.STA) is returned to this field. See Table 7-6 for 
a list of SVC7 error codes. 
lu is a l-byte field that contains a hexadecimal 
(SVC7 .LU) number indicating the logical unit assigned to 
the device that is to be renamed. 
Reserved is a 4-byte reserved field that must’ contain 
(SVC7.WKY) a zero. 
Device is a 4-byte field containing the device 
mnemonic mnemonic that is to replace the current device 
(SVC7.VOL) mnemonic in the device mnemonic table. 
Reserved is a 1l6-byte field that must be reserved with 
(SVC7.FNM) zeros. 
7.3.4 SVC7: Device Reprotect 


E-tasks can use the SVC7 reprotect function to define the type of 


access allowed to a device (e.g., read-only, 


The 


The SVC7 parameter 


write-only, etc.). 


e-task must have the device already assigned to the lu with 
ERW access privileges. 


block format and coding for reprotecting 


devices is shown in Figure 7-14. 


7-40 


48-038 FOO RO2 


H 12(2) Error H 
i Function code | status code } lu 
H 


(SVC7.OPT) (SVC7.STA) (SVC7.LU) 
| sis aa ie ls es ee inc Gini si“ ini Nimes ee “ci nis ‘ams “wm oe ‘uy suture a acm res abe Santo “es eh tata Vea i 
14(4) 15(5) 16(6) 
{ Write key | Read key | Reserved 
1 (SVC7.WKY) | (SVC7.RKY) | (SVC7.IRC) 
H a nieces “misc cats? ie (mena SO <A SNS SOD uh coum ch SD sh OUD FOND SEND ED GOD A DD Se OD SOP OOD OOD eS cee SEE DD GD nD Oe Mi SD OD OS OO 
18(8) 
' 
| 
i som nm em ne 
ae 

Reserved 

T (SVC7.VOL) 
} we seem 
}24(18) 
! 
( 

svc 7,parblk 

ALIGN 4 

parblk DC xX'0800' 

DB 0 

DB lu 

DB ‘write key' 

DB ‘read key' 

DC H'O' 

DC 0 


DB 0,0,0,0 


Figure 7-14 SVC7 Device Reprotect Parameter Block 
Format and Coding 


This parameter block must be 28 bytes long, fullword 


boundary-aligned, and located in a task-writable segment. 
description of each field in the parameter block follows. 
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A 


Fields: 


Function is a 2-byte field containing the hexadecimal 
code. number X'0800' indicating that the reprotect 
(SVC7.OPT) function is to be performed. 
Error is a l-byte field that receives an error code 
status when an error occurs during SVC7 execution. 
codes If no error occurs, a value of 0 is returned 
(SVC7.STA) to this field. See Table 7-6 for a list of 
SVC7 error codes. 
lu is a l-byte field that contains a hexadecimal 
(SVC7.LU) number indicating the logical unit assigned to 
the device that is to be reprotected. 
Write key is a l-byte field that contains a hexadecimal 
(SVC7.WKY) number indicating the new write protection 
keys for the device. . 
Read key is a 1-byte field that contains a hexadecimal 
(SVC7.RKY) number indicating the new read protection keys 
for the device. 
Reserved is a 2-byte reserved field that must contain 
(SVC7.LRC) a zero. 
Reserved is a 20-byte unused field that should be 
(SVC7.VOL) initialized with zeros. 
7.3.5 SVC7 Code X'FF80': Extended Close Function 
The extended close function closes an lu and replaces the date 
and time of allocation and the last write (or write filemark) 
operation in the disk directory with information stored in the 
SVC7 parameter block. This SVC7 function is available only to 


e-tasks or privileged u-tasks and d-tasks with the bare disk task 


option enabled. 


Figure 7-15 shows the parameter block format and coding for 


code X'FF80'. 


SVC7 
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ee eee een oe See me See See Se See SE ee ee ee A meme Se meee Ge See eee ee me Se ee ee Se ce ee om ee Ce ee Se ee ee Ome me ee Ser ae eee eee cme mee me ee me ee ee es ee 


10(0) |2(2) 13(3) | 
H Function code | Error status | lu 1 
J { ! t 
erates Ee ee eet ae ee eee ee ee eee , 
14(4) | 
| Allocation date/time } 
H (moved into DIR.DATE) } 
eee sn ese ie ‘Gosia “ns, cei" cas nn cls. meio es) Gan, ov Spur fee ces ne seam (cv ew “ska eas ts ems ee cena gah ee os eke es Se Ua ted re eS, -| 
18(8) 
| Last write operation date/time 
H (moved into DIR.LUSE) { 

svc 7,parblk 

ALIGN 4 

parblk DC X'FF80' 

DB L 

DB lu 

DC Y'allocation date/time' 

DC Y'last write operation date/time' 


Figure 7-15 SVC7 Code X'FF80' Parameter Block 
Format and Coding 


This parameter block must be 12 bytes long, fullwora 
boundary-aligned, and located in a task-writable segment. A 
general description of each field in the parameter block follows. 


Fields: 


Function code is a 2-byte field that contains the function 
code X'FF80' indicating that the SVC7 extended 
close function is to be performed. 


Error status is a l-byte field that receives an error code 
when an error occurs during SVC7 execution. 
If no error occurs, a value of 0 is’ returned 
to this field. If a nonprivileged task 
attempts to execute this SVC, a value of 1 is 
returned. See Table 7-6 for a list of SVC7 
error codes. 
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Allocation is a 4-byte field that contains the date and 

date/time time that is to replace the date and time of 
allocation in the DIR.DATE field of the disk 
directory. The format of the date and time 
must be the same format generated by the 
DATE.DIR routine in the File Manager Utility 
(FMUT) module. 


Last write is a 4-byte field that contains the date and 
operation time that is to replace the date and time of 
date/time the last write operation in the DIR.LUSE field 


of the disk directory. The format of the date 
and time must be the same format generated by 
the DATE.DIR routine in the FMUT module. 


7.4 SVC7 ERROR CODES 


If an error occurs during execution of an SVC7_ function, 
execution of the current function stops, and any other functions 
to the right of the current function are not executed. The error 
code indicating the type of error is stored in the error. status 
field of the parameter block. See Table 7-6 for the list of SVC7 
error codes. 


TABLE 7-6 SVC7 ERROR CODES 


_— — a os Se Re Se TE SE SE SS EE Se SE SE me ee Sere coe mes ee GD Sw ae ee See See eee ee es ee ee ee ces ee eee ee ee es ee ee ee Oe eee es Se oe ee me cee ee ee ee ee es oe 


| ERROR | FUNCTIONS | 
| CODE | AFFECTED MEAN ING 
H SSS SSS SSS SS VE SSE BTTETEAEBEBVEBSBEBEBSBE ESS ESE SS Ee EE 2 OS SS Se 2S SS SS | 
0 | All | Normal termination 
sate es aaa a a eo cag ec RE co EEL EA I | 
1 1 All | Illegal function code 
a ea aaa a a a a a 
2 | All except | Illegal lu specified { 
{| allocate | 
| Hoan er enn nnn rn en nen nn een 
3 | All except {| Specified volume is not mounted. | 
| rename 
i ak a a aa cs eae eld Sd ia eee als edt fetes ese a es I 
' ' 
| 4 | Allocate | Specified filename already exists on 
| rename | specified volume. 
| 
| Assign | Specified filename does not exist on 
H H | specified volume. 
a a ae a a a a ea a es as as ema Sk a a rae a a a a a a a Ft ee a Oo tt t 

J 

5 Allocate Insufficient space exists on specified 


ij volume to allocate a file of the | 
| specified size. | 
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TABLE 7-6 SVC7 ERROR CODES (Continued) 


ne Ram ee em me my mae SD Sem eee Sem ares ame Oe ny re em me, ms ee i ee ee ee ee 


ERROR {| FUNCTIONS 
CODE |; AFFECTED 


Re me Sees rm me Te nate ate eS ee my ee me ee ee me mee Se ne ne fe ee 


MEAN ING 


Se Ss OS 28S Ss Ss es ee EE 


6 | Assign Read/write protection keys do not match. 
' 
! 
{| Change Read/write protection keys do not match. 
{ 
I 
| Access 
| 
{ 


privilege 


7 | Allocate | Entire disk is currently assigned as 
| } assign | ERW. Specified filename or device } 
| cannot be assigned because requested | 
| | access privileges cannot be granted. 
H | Change ; Current access privileges are not H 
| access i changed to new access privileges 
| privilege {| because the requested access | 
| privileges cannot be granted. 
| 
| | Reprotect | File is not assigned ERW. \ 

| Delete ; File assigned to another task (not 
| closed). 
| | 
{| Rename {| Read/write protection keys do not match. | 
H H |} File is not assigned ERW. 
(cnetecaseun eisai eg ighon eee oa a ne Gg 
8 | Assign ; There is insufficient space for file 
{ control block (FCB) and buffers. 
| | 
{| Close | System space pointer or pointers have 
H | become corrupted. | 
| 
| | Delete | Task has exhausted its allocation of ; 
i dynamic system space determined by Link. |} 
| nnn nnn nnn nn nnn nnn nnn nnn nnn nner ! 
9 {| Assign | The lu is already assigned or device is | 
| off-line. Magnetic tape drive does not | 
{| support software density selection. 
| | | | 
| Rename | The lu is not assigned. 
| | | | 
| Reprotect | 
| | | | 
i Close | 
| aa | | 
| Fetch 
{ attributes | 
| | | | 
{ Change 
| | access 
| | | 


privileges 
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SVC7 ERROR CODES (Continued) 


ens eS ee eet SO OE GED GEE Ew CS WES ee GED Gees SEED GED SRS SEED OWE SED MD Ge SWS SE OE CE SE GEE SEE SUS GE CUE SES SEE ES SED ER Cre EE Se Ee ORE Gey Gee fee Sone Sm SEY MR ERY Siew fei im come Gere Gm Gil) We RY ROTO si HD 


ERROR 
CODE 


FUNCTIONS 
AFFECTED 


VFC 


i 
| 
MEANING 
1 
! 


es ee ee ES SS GS RD EY Ge OR GS SR ED GS EH Ee Ge ew Gee Se See Gee ED Se SD GD Ge Ge Gee cee SEE ED Gee Ge BUR Gute Ger We ORY ERE ame Cain Ee Came cee cuee Stee ce Me MD ee ERED Udy GY See mn Roow Gee Met mane ome Le 


rename 


all 


Allocate 
delete 


Spoolfile 
assign to 
pseudo 
device 


Spoolfile 
assign to 
pseudo 
device 


Spoolfile 
Assign to 
Pseudo 
Device 


i 
! 
Specified volume is not a direct access | 
device. . 1 


Specified trap-generating device does H 
not exist in the system, is nota 
connectable device or is busy and 
cannot be connected. H 


ee ee se ees ees canes cee emma cr es ee ee ee ee ee ee ee ee ee ee eS Oe EE NE me ee tees ne me Om ee i ae Dee ee ce om OE mee a te ne ne 


Allocation or deletion was attempted on 
a system or group file. 


I 
! 
SPL/32 is inactive. i 
! 
t 


| 
SPL/32. | 
3 
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CHAPTER 8 
LOAD TASK STATUS WORD (TSW) SUPERVISOR CALL 9 (SVC9) 


8.1 INTRODUCTION 

SVC9 sets the initial TSW or replaces the current TSW located in 
the task control block (TCB) with a new user-specified TSW. The 
SVC9 parameter block is shown in Figure 8-1. Other methods’ used 
for setting the TSW are: 

e The TSW is optionally specified by Link. 


e@ A resident task terminates by reaching end of task, which 
causes the current TSW to be replaced with zeros. 


e A task trap occurs causing a TSW swap. 


Storing TSW values into the user-dedicated location (UDL) does 
not change the current TSW. 
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SVC9: LOAD 


disable bits 


Wt 

ja; Trap enable/ 
ii} 

it | [8] 


oe ee cae ene ee ee ee ee 


TASK STATUS WORD (TSW) 


we ee ee me ee ce ee ee ee oe ce ee ee ee ee wee ee ee ee ee ee ee ee em we ee ee cee ee ee eet ee ee 


Queue entry 


H enable/disable | Condition | 

Reserved |} bits | code (CC) | 
(6) [13] (4) 

a a am fa a a a a sce in ha a a ee ae an ere cee er ie an “ey eg ews H 
Location counter H 

[32] 

| 

] 


i ee ie eed 


9,A(parblk) 


ALIGN 4 


parblk DC 


Y'bits O through 31' 


DCF A( location counter ) 
NOTE 
The decimal numbers enclosed within 
brackets ({ ]) in the parameter block 
indicate the number of bits the field 
contains. 
Figure 8-1 SVC9 Parameter Block Format and Coding 
This parameter block must be eight bytes’ long and fullword 


boundary-aligned. 
block follows. 


Fields: 


Wait 


Trap 


enable/ 
disable bits 


A description of each field in the parameter 


is a l-bit field indicating whether the task 
is to enter a suspended state or is currently 
waiting for a trap. This field corresponds to 
bit 0 of the TSW. 


is an 8-bit field that must indicate, through 


its trap bit settings, whether a trap is 
to be taken when a trap-causing condition 
occurs. This field corresponds to the trap 


enable/disable bits of the TSW. 
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Reserved is a reserved 6-bit field that must contain 


zeros. 

Queue entry is a 13-bit field that must indicate, through 

enable/ its queue bit settings, whether an item is to 

disable bits be added to the task queue when a queue 
entry-causing condition occurs. This field 


corresponds to the queue entry enable/disable 
bits of the TSW. 


Condition is a 4-bit field stored in the processor 
code (CC) CC. For an explanation of the CC, see the 
appropriate processor user's manual. This 


field corresponds to the CC bits of the TSW. 


Location is a 4-byte field that must contain the 
counter address where task execution is to start or 
resume. This field corresponds to the 


location counter (LOC) of the TSW. 


8.2.1 Function and Description of the Task Status Word (TSW) 

The TSW consists of two fullwords (see Figure 8-2). The first 
fullword, the status portion of the TSW, contains the: 

@ Trap wait bit 

@e Trap enable/disable bits 

@e Reserved bits 

@ Queue entry enable/disable bits 


@e cc bits 


The second fullword of the TSW contains the LOC. 


SVC9 allows the user to enable or disable the trap wait, trap and 
queue entry bits in the status portion of the _ TSW. It also 
allows the user to set the CC setting in the status portion and 
the LOC in the counter portion of the TSW. See Table 8-1 for the 
TSW bit definitions. 
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5616-2 


RESERVED RESERVED 


‘elt lolz e| 
K|DIT|, : 


BITS 0123 45 67 8 14 15 16 17 18 19 20 21 22 23 24 | 26 27 28 31 


RESERVED 


BITS 32 39 40 63 


Figure 8-2 Task Status Word (TSW) 


TABLE 8-1 TSW BIT DEFINITIONS 


ee ee ee ee ee ee ee es Se ee ce eee Se Se ee eee me ce ee eee ee ee ee ee ee ce eer es ee ee ee ce ce. ee ee ee oe ce ee ee ee ee ee ee ee ee ee 


BIT { | 

POSITION | BIT NAME AND MASK |} MEAN ING 

= SSS Se SS SS SS SS OS SE EE es 2 2 2 Os a 2 2 es 2 ss ES 2 | 

O (W) | Trap wait (TSW.WIM) | Task is suspended until a H 

} (Y¥'80000000' ) } trap occurs or until | 

} cancelled. 

Sn ae i i es i ns nein “el me sen im“ se, ce i es | 

1 (P) {| Power restoration | A trap occurs when power is | 

| trap enable/disable | restored after a power fail- } 

| (TSW.PWRM) } ure. H 

| (Y¥'40000000') H 

| After power is restored, all | 

} outstanding timer traps are | 

} lost. Any trap wait or time | 

H | wait conditions in effect 1 

j are lost, and task execution | 

} continues with the instruc- | 

| tion following the one that | 

j caused the trap. 

eS Sa eal “en i sien: ae a“ sa “as se ‘stew isn ae emacs “eu onl ne a ‘tae eel { 

2 (A) {| Arithmetic fault | A trap occurs when an arith- | 

| trap enable/disable | metic fault occurs. 

| (TSW.AFM) H H 

i (¥'20000000' ) H | 

feet i ene ces em memes es te mee ee se nee er men sce ee a me ee es ae se ee ce oe eee ee ee ee eee ee we ee eee ee ee ee H 
3 (8S) SVC14 execution Allows execution of SVC14. 


(TSW.S14M) 


' ! 
! J 
| trap enable/disable | 
{ | 
I | 
+ (¥'10000000') H 
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eh ieee ns RS Re Se TN Se mn Comey. GE, ewes. Semmes soteeme mam mie Mies fens me em em mere ements mem SOMITE mn creme SE ey ee ee Se me me ee ee ee 


BIT { i 
POSITION {| BIT NAME AND MASK } MEAN ING 

4 (Q) {| task queue service | A trap occurs when an item 
{| trap enable/disable | is added to the task queue 
| (TSW.TSKM) | or when at least one item 
} (¥'O8000000' ) | exists on the queue. 

5 (M) | Memory access fault | A trap occurs’ when the task 
| trap enable/disable {| attempts to access memory 
| (TSW.MAFM) | outside its task boundaries. 
| (¥'O04000000' ) 

6 (1) } Illegal instruction |} A trap occurs when the task 
| trap enable/disable | tries to execute an illegal 
| (TSW.1ITM) } instruction. 

i (€¥'O2000000' ) H 

7 (R) { Data format trap | A trap is taken when the 
| enable (TSW.DFFM) | task executes an instruction 
i (¥'O1000000' ) | that causes a data format or 
} alignment fault. 

8 (C) } Central processing | Task is executed on the CPU 
} unit (CPU)-override |} and cannot be transferred to 
} status (TSW.CPOM) } an auxiliary processing unit 
i (Y'OO800000' ) | (APU) for processing. (This 
| | bit applies only to tasks 
} running on the Model 3200MPS 
H | System. ) 

9-14 | Reserved i Must contain zeros. 

15 (K) | Subtask queue entry }| An item is added to the 
| enable/disable |} monitor task queue each time 
| (TSW.SUQM) | the subtask status changes. 
i; (Y¥'0GO0010000' ) H 
16 (D) | Device interrupt } An item is added to the task 
| queue enable/ | queue when a trap-generating 
| disable (TSW.DIQM) | device connected to a task 
; (¥'OOO0O08000' ) |} interrupts task execution, 
i } or when an SVC6 sint func- 
i | tion is directed to a task. 
17 (T) ‘Task call queue An item is added to the task 


entry enable/ 
disable (TSW.TCM) 
(Y'00004000' ) 
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TABLE 8-1 TSW BIT DEFINITIONS (Continued) 


queue when an SVC6 queue 
parameter function is 
directed to this’ task. 


TABLE 8-1 TSW BIT DEFINITIONS (Continued) 


BIT 
{ POSITION | BIT NAME AND MASK } MEAN ING | 
H we Se SS SS Ss ES Se Ee Ss Se Se 2 2s 2 Se se ee ee ee es 2 a es | 
| 18 (AP) |} Queue entry on | Adds a parameter to the task | 
i { signal from APU | queue when an APU signals H 
' | (TSW,APTM) } the CPU. 


y'O0000 2000' 
[Saeed a ee pe ed et pe Te igle he pe nea ee ee ce Tye ayy ie Ves a ye ee gee 
{| 19 (EB) | Task Message Queue | An item is added to the task | 
| | Entry Enable/Disable}| queue when an SVC6 send mes- | 
H ; (TSW.PMM) | sage function is directed to } 
H | (¥'00001000' ) } a task. 
pers vic sie nedaie ences al ae pe eames = Gs ees Ree | 
; 20 (L) | Load and Proceed {| An item is added to the task | 
; Completion Queue } queue when an SVC6 load and j| 
| i Entry Enable/ | proceed function is executed | 
| Disable (TSW.LODM) | and the load is completed. 
i; (Y¥'OQ0000800' ) H 
[SSS soe ees eee SSeS ees See ee Se Se eee eee eS ees 
i; 21 (0) {| Input/Output (1/0) |} An item is added to the task |} 
H | Completion Entry } queue when an SVCl I/O and | 
| Enable/Disable } proceed function is executed | 
} | (TSW.IOM) |} and the 1/0 is completed. | 
H | (¥'O00000400') H H 
eae airtel Gage gre acim ada Saga ial ok ed eT | 
i 22 (Z) | Time Interval | An item is added to the task |] 
;} Completion Queue | queue when an SVC2 code 23 
H | Enable/Disable } is executed and the interval | 
i | (TSW.TMCM) | has elapsed. | 
i €¥'00000200' ) | 
[eer eee er ree ee eee i ere ee ee 
| 23 (F) i} SVC15 Function } An item is added to the task } 
{| SVCl Buffer Trans- j;| queue when an SVC15 function |} 
| fer Completion | ig completed. See the OS/32 |} 
H | (TSW.1TM) | Basic Data Communications H 
H | (¥'O00000100' ) | Reference Manual. An item { 
| is added to the task queue 
} each time the magnetic tape | 
| | Griver adds a buffer to the 
H | OUT-QUEUE. H 
| manne nnn nnn nn nnn nnn nnn nnn nen enn een nen | 
; 24-25 | Reserved | Must contain zeros. 
eee eee a pee rr ee ee Sea ae ae eae eee aes 
26 (TE) Event Queue Service A trap occurs when an item 


Enable/Disable 
(TSW.TESM) 
(Y'00000020') 


i} is added to the system event | 
i; queue or when at’ least one | 
;} item exists on that queue. 
i For more information on the jj} 
| event queue service enable/ |} 
| Disable, see the 0OS/32 | 
| System Level Programmer 
| Reference Manual. 
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TABLE 8-1 TSW BIT DEFINITIONS (Continued) 


ees re me meee mee ne eee re ee St rm cee met Gee me mes cee eee mm me ers me ce me ee mm mee cee me mee mes mes ee ee me ee ee ne me ms eens i em ee eee 


BIT 
BIT NAME AND MASK | MEAN ING 


! 
data call enable | queue when an SVC6 send 
(TSW.SDM) | message function is directed 
1 
{ 


27 (SD) {| Queue entry on send } An item is added to the 
| 
! 

; (Y¥'OOO000010) 


to the task. 


| 28-31 ; CC | The CC following SVC9 is set | 
1 (CC) i | from these bits. H 
la ngeonmeress Ror nn nnn | 
| 32-63 i Location counter } Contains the current loca- 
H (LOC) i (TSW.LOC) ;} tion counter. 
NOTE 
see the 0S/32 Application Level 


Programmer Reference Manual for a 
description of the items that can be 
added to the task queue. 


If execution of an SVC9 loads a TSW with the trap wait bit 
enabled, the task is placed in a suspended state until one of the 
traps that are enabled in the same TSW occurs. However, if the 
task is placed in a suspended state and all other trap bits are 
disabled in the same TSW, the task remains in a suspended state 
indefinitely or until it is cancelled. 


If execution of an SVC9 loads a TSW with one of the trap bits 
enabled and that trap occurs, the trap is handled as described in 
the OS/32 Application Level Programmer Reference Manual. 


If execution of an SVC9 loads a TSW with one of the queue entry 
bits enabled and ae previously allocated item is placed on the 
task queue, no trap occurs unless the queue service trap bit of 
the TSW is enabled. 


When a TSW swap occurs and the current TSW is replaced with a new 
TSW, task execution resumes with the instruction located at the 
address specified by the LOC of the new TSW. If the address of 
the new TSW is outside the task boundaries, the task is paused 
and a message is displayed. If execution of an SVC9 loads a TSW 
that has zeros in the LOC field, execution resumes with the 
instruction following the SVC9. 


When SVC9 loads a new TSW, the CC of the new TSW becomes’ the 
current CC. Any value ranging from 0 to 15 (X'OO' to X'OF') is 
legal. If the TSW being loaded was previously saved as an old 
TSW during a TSW swap, the CC is restored. 
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CHAPTER 9 
OVERLAY LOADING SUPERVISOR CALL 10 (SVC10) 


9.1 SVC10: OVERLAY LOADING 


SVC10 is an internal call that provides for the automatic loading 
of overlays generated by Link. SVC10 is not available to users. 


If an overlay load fails to occur, a message indicating the 
reason for the failure is displayed to the log device. Overlay 
load failure can result from an input/output (1/0) error or from 
faulty coding that destroys the overlay control structure. For 
example, user code can be written in such a way as to destroy 
data in the overlay reference table. This table, which forms a 
part of the root segment and of each overlay area, contains 
pointers into the task overlay descriptor table (ODT), which 
contains the information needed to process the overlay. Without 
this information, SVC10 cannot perform the load function. 


The overlay descriptor table entry (ODTE) is part of the overlay 
reference table and represents the position in the ODT that 
contains processing information for the overlay to be _ loaded. 
Both the overlay reference table and the ODT are operating system 
data structures and are defined in the system macro library. 

9.2 MESSAGES 

The following message is displayed when a load failure occurs as 
a result of an I/O error. 


Format: 


I/O ERROR xxxx LOADING OVERLAY nnnnnnnn 
FAULT LOCATION yyyyyy (22z22z) 
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Where: 


xxxXX | is the I/O error status (see Table 9-1). 


nnnnnnnn is the name of the overlay that was being 
processed when the error occurred. 


YYYYYY is the virtual address of the SVC that caused 
entry into the SVC10O handler. 


ZZZZZZ is the physical address of yyyyyy. 


The following message is displayed when an overlay load failure 
occurs as a result of faulty coding within an overlay control 
structure. 


Format: 


OVERLAY ERROR xx NAME = nnnnnnnn 
FAULT LOCATION yyyyyy (22ZZ22ZZ) 


Where: 

XX is the error status. See Table 9-1 for error 
aefinitions. 

nnnnnnnn is the name of the overlay that was being 
processed when the error occurred. If it 
cannot be determined whether the error 
occurred in the root or in an overlay, NAME = 
nnnnnnnn is omitted from the message. 

YYYYYY is the virtual address of the SVC that caused 
entry into the SVC10 handler. 

ZZZZ2Z is the physical address of yyyyyy. 


If the overlay load failure resulted from a malfunction of SVC1O, 
the task is paused with the current program status word (PSW) 
pointing to the SVC1O instruction causing the failure. 
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TABLE 9-1 OVERLAY ERROR CODES AND MEANINGS 


MEAN ING 


.ODTE exists outside the range of the ODT range. 


There is user space violation of overlay start 
address. 


There is user space violation of overlay end 
address. 


Highest level overlay required by this SVC was 
not found. 


OVL size is less than 10 bytes; eight bytes for 
two fullword overlay reference table entry 
pointers plus a 2-byte instruction (BR) is the 
minimum size for an overlay. 


There is user space violation of the overlay 
reference table address in ODT entry. 


Pointers to overlay reference table entries are 
unreliable. The address difference between 
these pointers must be zero or an even multiple 
of eight bytes. 


There is user space violation of overlay 
reference table entry pointers. 


-ODTE index in ORT is out of ODT range. 


* Indicates possible destruction of data 
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CHAPTER 10 
AUXILIARY PROCESSING UNIT (APU) CONTROL 
SUPERVISOR CALL 13 (SVC13) 


10.1 SVC13: AUXILIARY PROCESSING UNIT (APU) SERVICES 


SVC13 provides a task with an interface to the APU in a Model 
3200MPS System environment. SVC13 gives a task the ability to: 


@ access status information on all APUs and APU task queues in 
the system, 


@e direct the flow of tasks to an APU task queue, and 


@® direct the execution of tasks on an APU. 


Table 10-1 lists the SVC13 function codes, which provide these 
capabilities. 


Functions O and 1] are available to any task in a Model 3200MPS 
System. Function 2 is available only to tasks in a Model 3200MPS 
System that have been linked with the APMAPPING task option. 
Function 3 is available only to tasks in a Model 3200MPS System 
that have been linked with the APCONTROL task option. See the 
OS/32 Link Reference Manual for more information on building a 
task with these task options set. 


TABLE 10-1 SVC13 FUNCTION CODES 


| FUNCTION CODE |} MEAN ING 
! Eerste rtrSBs esse fs 22ers Sees Stet SZSe22S 22 E28 SSTSISTESEKVMAS SSS FSIstsS ec SS SSS KI STS SS SS ST TST = 
SVC13 code 0 !} Read APU assignment and mapping information. 


SVC13 code 1 Read APU/APU queue status. 


SVC13 code 2 Execute queue mapping option. 
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The following sections describe how to access each of the SVC13 
functions from an application task running on a Model 3200MPS 
System. 


10.2 SVC13 CODE 0: READ AUXILIARY PROCESS ING UNIT (APU) 
ASSIGNMENT AND MAPPING INFORMATION 


SVC13 code 0 enables a task to copy onto a data buffer the 
maximum number of APUs (m) and logical processing units (LPUs) 
(n) allowed on the system followed by the tables of APU-to-APU 
queue assignment and of LPU-to-APU queue mapping. Both m and n 
are determined at OS/32 system generation (sysgen). See the 
System Generation/32 (Sysgen/32) Reference Manual. 


The table of APU-to-APU queue assignment contains one entry for 
the central processing unit (CPU) and each APU number. Each 
entry is l-byte, sequentially arranged starting with the entry 
for CPU (always 0), then for APU1 and ending with the entry for 
APUn, and containing the number of APU queue to which the 
respective processor is assigned. The APU gueue number value 
varies from 0 to n. 


The table of LPU-to-APU queue mapping contains one entry for each 
LPU number. Each entry is l-byte, sequentially arranged starting 
with the entry for LPUO (always 0) and ending with the entry for 
LPUn, and containing the number of the APU queue to which the LPU 
is mapped. The APU queue number varies from 0 to n. 


The data buffer where the above information is copied must be 
located in a writable segment of the task's address space. This 
buffer must begin on a fullword boundary. Figure 10-1 shows’ the 
parameter block and coding for SVC13 code 0. uv 
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10(0) 1i(1) i2(2) 13(3 
H Reserved {Function code } Reserved H Reserved H 
(SV13 .OPT) (SV13.FUN) {| (SV13.DOP) {| (SV13.APU) } 
' a a eee a Se Sn ser wfc a a Ts al sce as ens ean ae ee area he eee eee eo obs evens tend ; 
14(4) i6(6) 
H Reserved H Error status code 
H (SV13.APS) H (SV13 .ERR) 
Las Seana Rea ea eae eee ose eee eer SS a ae ee ee 
18(8) 
Data buffer start address 
(SV13 . BUF ) 
aa ee Sa cc ee ea i A ey ce ec es a a a Ne a en tS eee H 
{1L2(C) |} 14(E) 
Buffer used H Length of buffer 
(SV13 .USE) H (SV13.LEN) 

svc 13,parblk 

ALIGN 4 

parblk DB 0,0,0,0 

DB H'O' 

DS 2 

DC A( BUFFER) 

DS 2 

DC H'number of bytes' 


Figure 10-1 SVC13 Code 0 Parameter Block Format and Coding 


This 


parameter 
boundary-aligned, 


block must 


and located in 


general description of each field 


Fields: 


Reserved 
(SV13 .OPT) 


Function code 


(SV13.FUN) 


Reserved 
(SV13 .DOP) 


Reserved 
(SV13 .APU) 
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is a 1-byte 
initialized to 


is a. l-byte 
Gecimal number 


is a 1l-byte 
initialized to 


is a 1-byte 
initialized to 


be 16 bytes long, fullword 
a task-writable segment. A 
in the parameter block follows: 


unused field that 


zero. 


should be 


field that must contain the 
0 to indicate SVC13 code 0. 


unused field that should be 
zero. 
unused field that should be 
zero. 
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When SVC13 
information 
in Figure 10-2. 


Reserved 
(SV13.APS) 


Error 
status code 
(SV13 .ERR) 


Data buffer 


start address 
(SV13 .BUF ) 


Buffer used 
(SV13 .USE) 


Length of 
buffer 
(SV13 .LEN) 


code 


a a APS UD AD ee COE eee TEE ae Me oe 


| 1 
! | 
H Reserved i 
H Sas cd ae a a a es ee act estos ps a 
14(4) 
| ~ ———-- 
18(8) 
H APU 
H 
Bd Se anes Cae 
j12¢C) 
H 
' 
\— Sita a aa a a Sa eh eal ee cs oie ss 
}16(10) 
; LPU 
H 

Figure 10 
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is a 2-byte unused field that should be 
initialized to zero. 

is a 2-byte field that receives the execution 
status of SVC13 code 0. See Table 3-10 for 


a list of the SVC13 status codes. 


is a 4-byte field that contains the address of 
a user-specified buffer to which the operating 
system returns the assignment and mapping 
information. The buffer can be variable in 
length but must begin on a fullword boundary 
in a task-writable segment. 

actual 


is a 2-byte field that receives the 


number of bytes used in the buffer specified 
by the SV13.BUF field. 

is a 2-byte field that contains a decimal 
number indicating the maximum length (in 
bytes) of the data buffer specified in the 
SV13.BUF field. 
0 is executed, APU assignment and mapping 


is returned to the user's buffer in the format shown 


net eee cee ee re ee re ce ee em em ee me me ee eee ee ees ee ee ee ee ee ee ee ee ee ee ere ee ee ee wee ewe 


1(1) 12(2) 13(3) 
Maximum APU | Maximum LPU | Reserved 
number H number 
a ocean as rs Ps amin saa aes sin lal ca nw ate Sana es ae ar Cana ble ey, ee ie eS ee ! 
' 
aPae 

-to-APU queue assignment table 


eee ie TE eee ee ee 
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-2 Data Buffer Format for SVC13 Code 0 
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Fields: 


Reserved 


Maximum APU 
number 


Maximum LPU 
number 


Reserved 


APU-to-APU 
queue 
assignment 
table 


LPU-to-APU 
queue mapping 
table 


is a l-byte field that is reserved for future 
use. 


is a l-byte field containing the maximum APU 
number allowed in the system. This number is 
determined at sysgen. 


is a l1l-byte field containing the maximum LPU 
number allowed in the system. This number is 
determined at sysgen. 


is a l-byte field that is reserved for future 
use. 


is a variable length array (0O:m) of 1l-byte 
entries, each entry number i containing the 
number of the APU queue to which APUi is 
mapped, where APUO = CPU. The CPU entry is 
always OO. For example, in a system with four 
APUs, this table might represent byte sequence 
003230000000, where the CPU entry is 0, APU2 
and APU4 are assigned to queue 3, and APU3 is 
assigned to queue 2. 


is avariable length array (O:n) of l-byte 
entries, each entry number k containing the 
number of the APU queue to which LPUk is 
mapped. The LPUO is always mapped to queue 0. 
For example, in a system with six LPUs, this 
table might represent a byte sequence 
021033xx, where LPUO and LPU3 are mapped to 
queue O, LPUl is mapped to queue 2, LPU2 is 
mapped to queue 1, LPU4 and LPU5 are mapped to 
queue 37 and the table is filled with 
undefined bytes x to the fullword boundary. 


10.3 SVC13 CODE 1: READ AUXILIARY PROCESSING UNIT (APU) /APU 


QUEUE STATUS 


SVC13 code 1 allows a task to access information on the status of 
each APU and/or APU queue in a Model 3200MPS System. The APU 
status includes the: 


e@ APU hardware status 


@ Number of the APU queue to which APU is assigned 


@e Status of APU writable control store (WCS) 


e APU software status 
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e APU software status after power fail 
e Configuration options set for the APU 


@ Name of the task currrently active on the APU or of the task 
for which the APU is waiting 


@e Name of task with control rights over the APU 


e wCS image file descriptor (fd) 


The APU queue status includes the: 


@ Queue processing status 

@e Number of APUs assigned to the queue 

@ Number of LPUs mapped to the queue 

@ Name of the task with mapping rights over the queue 

@ Names of all tasks in the queue (or name of the task having 


exclusive rights to the queue) 


Figure 10-3 shows the parameter block format and coding for SVC13 
code l. 
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10(0) 11(1) 12(2) 13(3) APU/APU 
Options i Function code} Reserved | queue number 
| (SV13.OPT) | (SV13.FUN) | (SV13.DOP) {| (SV13.APN) 
a te a a I nN a a a At Ne eh te se 
14(4) | 16(6) 
H APU hardware status H Error status code 
(SV13 .APS) H (SV13.ERR) 
t ts i pe inna Suh sma ala es V/s “Sls “bh mt mh “ani ind“ abs cn I eS a can Ss em “sp Sl a var New me 
18(8) 
H Data buffer start address 
(SV13 . BUF ) 
H a se im inch nth“ eh i, we “cS ee, nc a: we as el es Sener a 
1 12(C) | 14(E) 
Buffer used 1 Length of buffer 
(SV13 .USE) H (SV13 .LEN) 

svc 13,parblk 

parblk ALIGN 4 

DB 0,1,0 

DC ‘APU or APU queue number' 

DS 4 

DC A(buffer ) 

DS 2 

DC H'number of bytes in buffer' 


Figure 10-3 SVC13 Code 1 Parameter Block Format and Coding 


This parameter block must be 16 bytes long, fullword 


boundary-aligned, and located in a task-writable segment. 


A 


general description of each field in the parameter block follows. 


Fields: 
Options contain one or both of the following fetch 
(SV13 .OPT) status functions: 
OPTION FUNCTION 
X'80' Fetch APU status. 
x'40' Fetch APU queue status. 
NOTE 


If both options are specified, the 
APU status is fetched; then the 
status of the queue to which the 
APU is assigned is fetched. 
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Function code 
(SV13 .FUN) 


Reserved 
(SV13 .DOP) 


APU/APU queue 
number 
(SV13.APN) 


APU hardware 
status 
(SV13.APS) 


Error status 
code 
(SV13 .ERR) 


Data buffer 
start address 
(SV13 . BUF ) 


Buffer used 
(SV13 .USE) 


Length of 
buffer 
(SV13 . LEN) 


is a 1l-byte field that must contain the 
decimal number 1 to indicate SVC13 code l. 


is a l-byte unused field that should be 
initialized to zero. 


is a l-byte field specifying a decimal number 
that represents: 


@ APU number (1-9) to which this call is 
directed if option X'80' is specified. 


@ APU queue number (0-9) to which this call 
is directed. Applicable only if option 
X'40' is specified by itself. 


is a 2-byte field that receives the APU 
response status from the APU processor 
hardware for option X'80'. 


is a 2-byte field that receives the execution 
status of SVC13 code l. The first byte of 
this field indicates bit position (0 through 
lL) of the SVC13 code 1 option being executed 
when the error occurred. The second byte 
contains one of the SVC13 error status codes. 
See Table 10-10 for a list of the SVC13 status 
codes. If no error occurs, both bytes contain 
0. 


is a 4-byte field containing the address of a 
Gata buffer to which SVC13 is to return the 
fetched status information. The buffer can be 
variable in length, but it must begin on a 
fullword boundary and be located in a 
task-writable segment. If the buffer is less 
than eight bytes in length, an error code 
(insufficient buffer space) is returned and no 
data is written to the buffer. 


is a 2-byte field that receives a decimal 
number indicating the actual number of bytes 
used in the buffer specified by the SV13.BUF 
field. 


is a 2-byte field that contains a decimal 
number indicating the maximum length (in 
bytes) of the data buffer specified in the 
SV13.BUF field. 
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124(18) 
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128(1C) 


1 36(24) 


When SVC13 code 1 option X'80' only is executed, 
the 


rmat. shown in Figure 10-4. 
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}1(1) 12(2) Queue 
number |} Queue } number at 
} numbe H 


power fai 


L 


information 
status of the specified APU is returned to the user's buffer 
in the fo 


t 
! 
H Reserved 
i 
' 


Seti emeeti mentale creme Die Di nT an en A ee en Co ene NT en 


Active task name 
or 
Waiting task name 


Control task name 


WCS image fa 


APU options 
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Figure 10-4 Data Buffer Format for SVC13 Code l 


Option X'80' only 
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Fields: 


APU number 


Queue number 


Queue number 
at power fail 


APU 
processing 
status 


APU options 


Active task 
name or 
waiting task 
name 


Control 
task name 


WCS image 
fd 
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is a l-byte field containing the number of the 
APU to which the status information applies. 


is a l-byte field containing the number of 
the APU queue to which the APU is assigned. 


is a 2-byte field containing the number of the 
APU queue to which the APU has been assigned 
at the time of the last power fail. 


is a 2-byte field that contains the wWCS 
state for the specified APU, the current APU 
software state and the APU state at the time 
of the last power fail. 


Figure 10-5 shows the APU processing status 
field. See Table 10-2 for the bit definitions 
for this field. 


is a 2-byte field that is set according to the 
configuration options in effect for the 
specified APU. See Table 10-3 for the bit 
definitions for this field. 


is an 8-byte field containing the name of the 
currently active task. If the APU is’ stopped 
and waiting for a task, this field contains 


the name of the currently waiting task. The 
task name is left-justified with trailing 
blanks. If no currently active or waiting 


task exists, the entire field is filled with 
blanks. 


is an 8-byte field containing the name of the 
task having control rights over the’ specified 
APU. If no control task exists, the entire 
field is filled with blanks. 


is a l6-byte field containing the file 
descriptor of a writable control store image 
file loaded into the APU during its power-up 
initialization. 
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| power fail 


status 
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Figure 10-5 
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| Reserved 
| for future 
; use 
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State at 


fail 


| Reserved 

| for future 
; use 

( 

| 


Tee ee ene ee etn neti emit ee ae ee cert ale ee Be see i td 


Current 
status 
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BIT DEFINITIONS FOR APU PROCESSING STATUS 


to U-Task Buffers 


FIELD RETURNED TO U-TASK BUFFER 


Oe ee en ee eee tee eee ee 


BIT ! 
POSITION } 
0 ! 1 = wes 
| O = WCs 
1 | 1 = wes 
| 0 = wCcs 
2-5 
! 
! 
! 
! 
6-7 {| OO = APU 
' 10 = APU 
! 11 = APU 
ing 
8-13 
14-15 ' OO = APU 
' 10 = APU 
' 11 = APU 
ing 


irik ba ieea 
not initialized 


loaded 


cee em ee ee ee ee we mn me ee ce ee me ee ee ee eee cm re ewe re ee ee en cee ee ee ee ee eee wen ee ee 


disabled 

enabled 

enabled and wait~- 
for task 


disabled 

enabled 

enabled and wait- 
for task 


Format of APU Processing Status Field Returned 
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TABLE 10-3 BIT DEFINITION FOR APU OPTIONS 
FIELD RETURNED TO U-TASK BUFFER 


APU 

| CONFIGURATION | BIT 
OPTION | POSITION | 
tm 

ts 

| WCS 0 1 0 
i 1 
| Floating 1 1 O 
i; point support |} H 

fo o1L 
i Trap block { 2 ; O 
t wait 

| i 1 
| Reserved for | 3-15 H 

| future APU 

| options 


BIT SETTING AND MEANING 


= APU has WCS 
= APU has no WCS © 


= APU has floating point 


support 


point support 


APU has no floating H 
! 
! 


= APU will continue pro- 
cessing during CPU 
fault handling 


ing and wait for a task 
during CPU fault 


handling 


= APU will stop process- | 
! 
! 
H 
J 


When SVC13 code 1 option x'40' 
status of the specified APU queue 
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is executed, 


information on the 


is returned to the user's 
buffer in the format shown in Figure 10-6. 
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i0(0) t1L(1) 12(2) 
\ Reserved } Queue ' Number of tasks | 
number ' in the queue 
H ses a al a Gil akg Wak i "Sh “ison tl ii cu“ nse eS“ “Sm eS e s '“ SlsenSa a e PS es eR Ee, : 
14(4) 16(6) Number :7(7) Number 
{ Queue processing status of APUs of LPUs | 
assigne mapped | 
H we SS ea ec Soy en ope Viol’ “Sey asm temas ala“ i seas "cil ats dk (ats) Sn ua “aaa cote“ cies ce Saw’ es arma Lebel ae Sew See ee “aes an es A a eat wh es ees oe fees catia tae co, Se a aa : 
18(8) 
| | 
cabelas Mapping task name 0 2 2 === == 
}12(C) 
| ! 
| | 
| a a a a en a a an ee ee H 
{16( 10) 
i ; 
t t 
| Queue task name (1) 1 
oalenieatenienton or current exclusive task name SG aaa ie 
{20(14) or exclusive task name at power fail 
i ' 
| : 
Lacan ae tae ir cae a pe aa oe | 
7 : 
a a eh as SS aos Sar 1 Bes Sema cSeai Vos sis Soc es “tas Se ssh aes ch aus ee “wt ws aca che rw toms TSS lc Vin es nas; sh aa eh stn ag Mat cases ce ' 
t ' 
| 
| 
~s Queue task name (n) SSS 


ee NN ee ten nearer ee he A hee ea Ae em eee ee eee ee ee cee eee eel 


Figure 10-6 Data Buffer Format for SVC13 Code l 
Option X'40' Only 
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Fields: 


Queue 


Number 
tasks 
queue 


Queue 
proces 
status 


Number 
APU as 


Number 


number 
of 


in the 


sing 


of 
signed 


of 


LPUs mapped 


Mapping task 


name 


Queue 
name ( 


task 
n) or 


exclusive 
task name 


is a l-byte field containing the number of the 
queue to which the status information applies. 


is a 2-byte field containing the total number 
of tasks waiting in the specified APU's queue. 
Any task currently executing on the APU is not 
included in the total. 


is a l-byte field that contains the current 
queue status and the queue status at the time 
of the last power fail. 


Figure 10-7 shows the APU queue _ processing 
status field. See Table 10-4 for the bit 
definitions for this field. 


is a 1l-byte field containing the number of 
APUs assigned to the specified queue. 


is a l-byte field containing the number of 
logical processor mapping table (LPMT) entries 
mapped to the specified APU. 


is an 8-byte field containing the name of the 
task having mapping rights over the specified 
APU. If no mapping task exists, the _ entire 
field is filled with blanks. 


is avariable length table of 8-byte fields 
containing the name of each task in the APU 
queue. The order of entries corresponds to 
the order of the tasks in the queue. 


When the specified queue has been marked on 
exclusively for one task, the queue is always 
empty. In this case, this field contains’ the 
name of the task having exclusive rights to 
the queue. 


ce ee es ee re ee es a ome ae ee es ee ee ee ere re ee re ee ee re ee ee ee ee a a ee a ee a a ee ww ee ee 


State at last | Reserved } Discipline 
' ' 
' i} 


power fail 


| Current 
| state 
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Figure 10-7 Format of APU Queue Processing Status Field 
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Returned To U-Task Buffer 
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TABLE 10-4 BIT DEFINITIONS FOR APU PROCESSING STATUS 
FIELD RETURNED TO U-TASK BUFFER 


} QUEUE H BIT H | 
H STATUS |} POSITION } BIT SETTING AND MEANING } 
| Hee eR SSSR RSS SSSR SSSR OS RSS SST SSS SST SESS SSS |} 
| Reserved H 0-2 1 { 
| for future | | ! 
| use | | | 
H aks nas es nes sen |ivscn “ees a “ec <tc mae ee. Semin: sucess staan sae“ an ab Scenes “ak Pst cm ee Stew | Ss so Sau { 
| State at i 3 and 4 ; OO = queue OFF 
| last power | | OL = queue ON 
| fail H | Ll = queue ON-exclusive | 
psa SS SSeS aaa Se area eee ea aS Se Sa 
|} Reserved 5 | | 
| for future | through | 
| use it 
beet 2a SR ee eee SSS aS S esa aa ore se a 
i Queue i; 8 and 9 {| OO = no priority 
| Discipline ; | Ol = priority 
H H } Ll = priority-enforced | 
[SSS Sess SSS SSS Se ae SSe SSS een ame eae 
| Reserved H 10 { H 
| for future |} { I 
| use 
(Se Sea ee SSeS eS See eee eae eee it, 
; Current | ll and 12; OO = queue OFF 
| status | OL = queue ON 
H } Ll = queue ON-exclusive | 
[pase eee Sa Se ee SS eS SSS Sr ea ee ree 
| Reserved } 13 ; 
{ for future {| through | 
' use 15 H 


When SVC13 code 1 option X'CO' (options X'80' and X'40' combined) 
is executed, information on the status of the specified APU 
followed by information on the status of the queue to which the 
APU is assigned is returned to the user's buffer. The first part 
(APU status) format is presented in Figures 10-4 and 10-5 and 
Tables 10-2 and 10-3. The second part (queue status) starts at 
byte offset 36(24), and its format is presented in Figures 10-6 
and 10-7 and Table 10-4 where byte addresses of the Figure 10-4 
are incremented by 36(24). 
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10.4 SVC13 CODE 2: AUXILIARY PROCESSING UNIT (APU) MAPPING 
FUNCTIONS 


SVC13 code 2 allows a task to perform mapping functions on a 
specified APU queue, provided the task has the mapping rights to 


the specified queue. A task is granted mapping rights to a queue 
only if: 


@ the requesting task has been link-edited with the APMAPPING 
option, and | 
@ no other task has been granted mapping rights to that queue. 


Operator commands for APU mapping are not accepted if a task 
already has these mapping rights. 


Once a task has been granted mapping rights to an APU, the task 
can: 

@ Mark the queue on or ON-exclusive to only one task. 

@ Map an LPU to the queue. 


@ Map to queve O all LPUs that are mapped to the _ specified 
queue. 


@e Set new queue discipline. 


@e Mark the queue OFF. 
NOTES 


1. Queue O is always marked on. Marking 
it ON-exclusive or OFF-exclusive is 
prohibited. 


2. Marking a queue ON-exclusive is 


Gisallowed if more than one APU is 
assigned to the queue. 


Figure 10-8 shows the parameter block format and coding for SVC13 
code 2. 
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tee ie tie a I a ee I a I ee ee Teen ee ee Ere 


10(0) {1¢1) Function {2(2) :3(3) APU queue 
Options code | Directive number 
(SV13.OPT) H (SV13.FUN) i (SV13. Ber? { eyo REN? } 
1 st ets“ ie an ma yi San ca et ib imi eG een a in Naa eed his a a i es cs nin i cm se a” fa ee oa aaa Sa ; 
14(4) 16(6) Error 
1 Reserved i status code } 
(SV13. APS) _(svi3. ERR) 
t 

i &(8) 
1 Data buffer start address } 
(SV13 .BUF ) 
arise u ace ECan aa cece ms Oa EE ed an ! 
1 12(C) | 14(E) 
Queue discipline Length of buffer 
| (SV13. SF) H hla LEN ) 

Svc 13, parblk 

ALIGN 4 

parblk DC X'option(s)' 

DB 2 

DC ‘LPU number' or O 

DC ‘APU queue number' 

DC H'OQ' 

DS 2 

DC A( BUFFER) 

DC H'queue discipline' 

DC H'number of bytes in buffer' 


Figure 10-8 SVC13 Code 2, Parameter Block Format and Coding 


This parameter block must be 16 bytes long, fullword 
boundary-aligned, and located in a task-writable segment. A 
general description of the fields in this parameter block 
follows. 


Fields: 
Options is a l-byte field containing a hexadecimal 
(SV13 .OPT) number specifying one or more of the mapping 


functions. 


Figure 10-9 shows the APU mapping option field 
format. See Table 10-5 for the available 
options for this field. If more than one APU 
mapping option is specified, the options are 
executed in a left-to-right order. 
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Function code 
(SV13 .FUN) 


Directive 
option 
(SV13 .DOP) 


APU queue 
number 
(SV13 .APN) 


Reserved 
(SV13.APS) 


Error status 
code 
(SV13 .ERR) 


Data buffer 
start address 
(SV13 . BUF ) 


Queue 
discipline 
(SV13 .USE) 


Length of 
buffer 
(SV13 .LEN) 
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is a 1l-byte field that must contain the 
decimal number 2 to indicate SVC13 code 2. 


is a l-byte field that contains the LPU 
number for option X'10'. All other options 
ignore this field. 


is a l-byte field that must contain the number 
of the queue to which this SVC is directed. 


is an unused 2-byte field that should be 
initialized to zero. 


is a 2-byte field that receives the execution 
status of SVC13 code l. The first byte of 
this field indicates the bit position (0-7) of 
the SVC13 code 2 option being executed when 
the error occurred. The second byte contains 
one of the SVC13 error status codes (see Table 
10-10). If no error occurs, both bytes 
contain 0. 


is a 4-byte field that specifies the address 
of the buffer containing the name of the task 
to be granted exclusive access to the 
specified queue. The task name specified in 
this buffer must be eight bytes long and 
left-justified with trailing blanks. If the 
entire buffer is filled with blanks, the task 
issuing the SVC is granted exclusive access to 
the specified queue. This field applies to 
option X'40' only; all other options’ ignore 
this field. 


is a 2-byte queue field that contains 
queve discipline code for option X'40'. All 
other options ignore this field. The 
discipline code is one of the _ following 
decimal numbers: 


e O indicates no-priority 

e 1 indicates priority 

e 3 indicates priority-enforced 

is a 2-byte field indicating the length of the 
data buffer containing the name of the task to 
be granted exclusive access to the _ specified 


queue. This field applies to option X'40' 
only; all other options ignore this field. 
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t ‘] 
{ { 
' Gain } 
} mapping} 
{ rights | 


queue 
ON--ex- 


clusive} on 


ee ee ee ee eee me cee rm ce ce emcees ee ee ree ee ee eee eee ewe ee ee en ee wee ee ee ee ee ee ee ee ee ee ee ee ee 


1 2 


K 4 
» 
My 
a 


queue 


3 


| Map all | Set 
} queue {| queue 
| LPUs to ; discip- 
; queue O ; line 
4 5 


1 1 

! i] 

Mark | Release |} 

queue | mapping } 

off | rights | 
6 7 


Figure 10-9 SVC13 APU Mapping Options Field (SV13.0PT) 


TABLE 10-5 SVC13 CODE 2; APU MAPPING OPTIONS FIELD (SVC13.0PT) 
BIT DEFINITION 


Cel tes cae a Re cast a eee hoe oo en ee 


Co ee ee et ee ed 


Other than queue 


ce es me tee em me ee a ee em ec et em ee em te re ee ee 


APU MAPPING } BIT | HEX 
OPTION | POSITION } CODE 
Gain ! 0 ; X'80! 
mapping H 
rights i H 
| 
i] i) 
I 1 
§ 1 
1 1 
| | 
| | 
i] i] 
' ] 
Mark queue | 1 i; x'40! 
ON-exclu- i H 
sive 
| | 
! ' 
1 i] 
H I 
H H 
} { 
Mark queue H 2 i xX'20' 
on H | 
) i] 
1 1 
1 H 
Map LPU to ' 3 i x'10' 
queue H | 
H 
Map all : A i; X'O8! 
queue LPUs |} 
| ' 
' { 


Lo queue 0 
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DESCRIPTION 


Gain mapping 

rights to the 
specified APU 
queue for the 
task. 


Mark specified 
queue available 
for scheduling 
only the task with 
the name in the 
buffer starting at 
address SV13.BUF 
(see below). 


Mark specified 
queue available 
for scheduling 
arbitrary tasks. 


Map LPUn to queue. 
mn is indicated in 
$V13.DOP. 


Map to queue O all 
LPUs mapped to 
specified queue. 


PREREQUISITES 


SESESSPFZFSR KET ESSTESAZE SA SSOIOSFSHERSRAAREAEEEEAEREBSBARASAS SESS HRESSABSEOESTF ESSE SSS RS ESS SBS HS SBS Sss=— 


Task linked with 


APMAPP ING 
task option. 


No other task 


has mapping 


rights to the 
specified queue. 


0 specified. 


No more than 
APU assigned 
to the queue 


one 
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TABLE 10-5 SVC13 CODE 2: APU MAPPING OPTIONS FIELD (SVC13.OPT) 
BIT DEFINITION (Continued) 


eee SO me re ae ae cs ces we me cee cme crm cm em ees re mee ee cee ee se me ey ee ee ee ee ee ee ee ee ee ee ee ee ee ee 


code is indicated 
in SVC13.USE. 


| APU MAPPING | BIT | HEX | | H 
H OPTION | POSITION } CODE | DESCRIPTION { PREREQUISITES | 
| FSP SSeS SSS SE ESSER! 
| Set queue H 5 i X'O4' | Set discipline | None { 
| discipline { for specified { 
i] 
| 
H 


' t 
' | 
! 1 
|} queue. Discipline | 
! ! 
! 1 


| Mark queue ; 6 | X'O2' | Mark specified | Other than queue | 
| off H H | queue unavailable | O specified. | 
| for task schedul- {| _. 
i 1 ing 
Sie re a en ee ee ee eae ee See a ee ee ee 
| Release 1 7 i X'O1' | Give up mapping | None H 
|} mapping H H | rights to the spe- | H 
| rights H H i cified APU queue _ |} H 
' i} ‘ 1 ! ' 
t 1 4 1 ' U 


for the task. 


— em ee ee re cee ee ce ee eee eee ee ee cee ee ee ee ee ee ee ee ee ee er ee ee ee ee ee ee ee ei ee 


10.5 SVC13 CODE 3: AUXILIARY PROCESSING UNIT (APU) CONTROL 

SVC13 code 3 allows a task to perform control functions on a 

specified APU provided the task has obtained the control rights 

to the specified APU. OS/32 grants APU control rights to a 

requesting task only if: 

@e the task has been link-edited with the APCONTROL option, and 

@e no other task has been granted control privileges to the 
specified APU. Operator commands for APU control are not 
accepted if a task already has these control rights. 


SVC13 code 3 gives a task the ability to: 


@ Initialize an APU (perform a power up link check), enabling it 
for execution. 


@ Send a directive to control APU task execution. 

@e Stop the APU and preempt the currently executing task. 
@e Select the next task to execute on the APU. 

@ Assign the APU to an APU queue. 


@e Disable an APU for on-line maintenance. 


10-20 48-038 FOO RO2 


Figure 10-10 shows the parameter block format and coding 


SVC13 code 3. 


{0(0) APU 
; control 
;} options 
(SV13 .OPT) 


1(1) 12(2) 13(3) 
Function code} Directive ' APU number 
(SV13 .FUN) i option (SV13 .APN) 
' (SV13.DOP) } 
16(6) 


(SV13.APS) 


Cee ee dd ee 


Nn ee ee ee et 


(SV13 .USE) (SV13 .LEN) 
svc 13,parblk 
ALIGN 4 
parblk DB X'option' 
DB 3 
DB X'directive option' 
DB "APU number' 
DS Ll ' 
DS 1 or DB 'byte sent for link check' 
DS 2 
DC A( BUFFER) 
DC H'APU queue number' 
DC H'length of buffer' 


1 
1 
’ APU hardware status 
| 
! 


APU queue number 


H Error status code 
| (SV13.ERR) 


Data buffer start address 
(SV13 .BUF ) 


for 


—— ee ee 


ae 


Figure 10-10 SVC13 Code 3, Parameter Block Format and Coding 


This parameter 
boundary-aligned, 
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block must be 16 bytes long, fullword 
and located in a task-writable segment. A 
general description of each field in the parameter block follows. 
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Fields: 


APU control 
options 
(SV13 .OPT) 


Function code 
(SV13 .FUN) 


Directive 
option 
(SV13 .DOP) 


APU number 
(SV13 .APN) 


APU hardware 
status 
(SV13.APS) 


Error status 
code 
(SV13 .ERR) 
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is a l-byte field specifying a hexadecimal 
number indicating the APU control option to 
be executed. Figure 10-11 shows’ the APU 
control option field format. See Table 10-6 
for the available options for this field. If 
more than one APU control option is specified, 
the options are executed in a left-to-right 
order. . 


is a l1-byte field that must contain the 
decimal number 3 to indicate SVC13 code 3. 


is a l-byte field specifying a hexadecimal 
command code to be sent to the specified 
APU (see Tabie 10-7). This field is used only 
if X'O8' was specified in the APU control 
options field. The directive option field is 
ignored for all other APU control options. 


is a 1-byte field that identifies the 
specified APU. 


is a 2-byte field that contains one of the 
following: 


e If option xX'O8' is specified and any 
command other than LINK CHECK (X'80') is 
specified in the SV13.DOP field, this field 
receives the APU response status returned 
after execution of the specified command. 


e If option X'08' is specified and the LINK 
CHECK command (X'80') is specified in the 
directive option (SV13.DOP) field, the 
right-most byte of the halfword defines a 
data pattern (determined by the user), 
which is sent to the APU. The APU 
complements the byte and sends it back to 
the left byte of the field. 


is a 2-byte field that receives the execution 
status of SVC13 code 3. The first byte of 
this field indicates the bit position of the 
option being executed when the error occurred. 
The second byte of this field contains one of 
the SVC13 error status codes. See Table 10-10 
for a list of the SVC13 error codes. 


48-038 FOO RO2 


Data buffer 
start address 
(SV13 .LEN) 


APU queue 
number 
(SV13 .USE) 


Length of 
buffer 
(SV13 . LEN) 


1 t 1 
' ! i} 
; control {| Enable } 
H i APU \ 


is a 4-byte field that specifies the address 
of a buffer containing the name of the task 
on the APU ready queue that is to be selected 
as the next task to be executed. This task 
must be an existing member of the queue. 


This field applies to option X'10' only and is 
ignored for all other APU control options. 


is a 2-byte reserved field that specifies the 
number of the queue to which the APU is being 
assigned. This field applies to option x'04' 
only and is ignored for all other APU control 
options. 


is a 2-byte field specifying a decimal 
number (8 or greater) indicating the length of 
the data buffer specified by the SV13.BUF 
field. This field applies to option xX'10' 
only and is ignored for all other APU control 
options. 


Stop and ; Select ;} Send |} Assign | ; Release | 

reschedule | next {| APU i to | Disable } control | 

APU taske {| task | command { queue | APU | rights | 
2 3 4 2) 6 7 


Figure 10-11 


TABLE 10-6 


ee meee er ee eee eee ee ee er ee ree ee ee a re eee ee ee ee eee ee ee ate ee eee ee ee ee ee ee 


APU CONTROL 


' 

| 

H PRIVILEGE BIT 

| OPTION POSITION CODE |; DESCRIPTION | PREREQUISITES 

\eeaceersa2e seers BSereexe2sas=se22 Serre se2 S22 2S 222 22 SF 2®s2 SEZ SZSPS SSE Sl2L22 2222S S2222Lf26=°5=- 
Gain 0 X'80' {| Task gains control Task link-edited 

| rights to the with APCONTROL 

rights | specified APU. task option. 
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SVC13 APU Control Options Field (SV13.0OPT) 


SVC13 CODE 3, APU CONTROL OPTIONS FIELD 
(SV13.OPT) BIT DEFINITIONS 


! 
| 
HEX i 
4 


No other task 
has control 
rights to 
specified APU. 


ee ee we me me em ee ee ee ee ee ee 
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TABLE 10-6 SVC13 


CODE 3 APU CONTROL OPTIONS FIELD 
(SV13.OPT) BIT DEFINITIONS (CONTINUED) 


Reet meetieeeti eA De A Re Ee ee iititiendtiantiantinntianiondtiminetien tatiana 


APU CONTROL 


! ' 
y ' 
' PRIVILEGE BIT HEX 
| OPTION | POSITION | CODE } DESCRIPTION ' PREREQUISITES | 
|) PSP Se eee sce ee ee Ser eee eee REESE ESSA SERS REESE SSS SSS SST sess ess | 
' Enable APU} 1 ; X'40' {| Initializes speci- } APU must be in : 
| fied APU by per- | DISABLED state. 
| forming a power up |} APU must be ! 
| link check. After ; self-initial- 
H | power up Link ; ized. APU ! 
| check, APU is in | initailizes 
| | | an ENABLED state | itself when : 
; and idle. : powered up. 
[RReeS eS SSS Se SSS Sees ee eS eS ee ae SSS Sr Se eee eS eee see seaa oes s | 
| Stop and H 2 | X'20' | Stops execution of | APU must be in { 
| reschedule } | i the current task i ENABLED state. i 
| APU task 1 H | on the specified + APU must have a } 
| APU, saves the ; currently 
i | task context, and ; executing task. | 
1 | returns the task ' 
i | to the queue 
H H | according to queue | ; 
H H | GQiscipline and ; 
| task priority. 
| APU becomes idle. |; 
bees SS SSS ae ea Sea a ee are ee ee ee ea eee ere Soe 
| Select next | 3 ; X'10' | Select the task ; APU must be in H 
i; task 1 i specified in the | ENABLED state. H 
| buffer from the : The queue must 
| APU queue as the i be no-priority H 
{| next task for the ij with a single 
| APU to run. Tasks j; APU assigned. { 
| appearing in the 
| APU ready queue { 
| after this task ! 
| executes in order. } 
 estentaaietentententententestenteniotatertestontentenientntaresteatententetentertenteatentaertetententeretantntententenetenentenetentaneatenteteatntanentetentaamntatatemantatan 
} Send APU | 4 | X'O8' | Send the APU ; See Table 10-7. i 
| Command i i } command specified } H 
| in the Svc ! 
| Girective option 
| field (SV13.DOP) | 
| to the specified ' ! 
H i | APU. ‘ i 
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APU CONTROL | 
PRIVILEGE | BIT | HEX 1 
‘ ' \ 


OPTION i} POSITION {| CODE | DESCRIPTION {| PREREQUISITES 
Assign to H 5 ; X'O4' | Stop execution of | None 
queue current task if 


| 

‘ 

t 

| any, save the task 
; context and return 
| the task to the 

} queue according to 
; the queue disci- 

| pline and task 

|} priority. 
| the APU to the 

' 

' 


Assign 


queue 
| Disable APU } 6 i X'O2' | Disable the | APU must be in ' 
| specified APU. | ENABLED state. 
a a a ama aaa al H 
i Release H 7 i X'Ol' | Task gives up con- | None 
} control H H } trol rights to the }| H 
i rights H H | specified APU. H \ 
TABLE 10-7 SVC13 CODE 3, APU COMMANDS (SV13.DOP) 
| HEX | 
} CODE | MEAN ING H PREREQUISITES | 
|< Se eS oe Sm tn | 
} X'Ol' | Start APU for task execution. | APU must be idle. { 
| | APU enters running state. H : 
aka hc a haa a a a a a ca a cae eal eal H 
| X'O2' {| Execute single instruction. { APU must be idle. i 
H 
H ' | Reserved for diagnostic H 
| use. 
eras 1 
| X¥'O4' | Transfer current task to CPU | APU must be idle. | 
| | Not recommended for user- H } 
| written tasks. See SVC6 | APU must have a current 
| {| example in Chapter 6. | task. { 
| -a 2-2 2 nn nn nnn enn nn nn nn nnn nn nnn nnn nn nn nnn nnn nnn nn 
} X'O7' | Start APU for nontask { APU must be idle. H 
| } execution loads and starts | { 
| APU using power fail image. | Reserved for diagnostic } 
' use. i 
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TABLE 10-7 SVC13 CODE 3 APU COMMANDS (SV13.DOP) (Continued) 


Oe ee a i Ne eee een eee 


| HEX j 
{| CODE } MEAN ING { PREREQUISITES 1 
i SSeS Sess S 32S S52 2225S R22 SERB SSI SRA SRERBASBABZASEERSEREIEEAZFESASRZBEBS AEA AKL ESBHEARATEIERESTAADZZzZD | 
{ X'O8' | Store power fail image. {| APU must be idle. H 
| Reserved for diagnostic | 
; use. 
| ann nnn nn nn enn nnn nnn nnn nnn nnn nnn nnn enn ne naan a nesenae ns 
; X'OB' {| Stop APU if task state | APU must be running in H 
H | saves context of currently | task state (program status | 
| | executing task and stops APU | word (PSW) bit 15=0). 1 
H | (APU enters idle state.) | 
| APU must have a current 
| task. 
cere ai cgay arian GEES Rd SUE re me RO 
| X'80' | Real-time support module | APU must be idle. H 
} | (RTSM) link check - APU sends | { 
H | back complement to data byte |} Reserved for diagnostic H 
H | received. ;} use. 
 oreerrae aging tno cna a ais SSE: ga a cg Te aie ! 
| X'83' | Reschedules task on APU; APU ; APU must have a current 
H | reschedules the current task | task. H 
| to the rear of the APU queue. } 
' APU must be idle. 
] : | 
' ' 
NOTE H 
1 { 
! ! 
| The X'83' command temporarily disrupts task H 
H order in a priority or priority-enforced 1 
1 queue until the operating system restores it H 
| based on APU signals. A _ better method of 
H rescheduling a task on an APU is to issue an 
SVC13 code 3 with the X'20' APU control option 
H specified. | 
Seas Sos SSS se Seen SSeS a esa See Se a See ae Saas 
i X'85" | Stop APU and save power fail | Use only after attempt to | 
H | image - APU saves context of | stop APU with X'OB' has 
H | currently executing task and |; failed. | 
H | Stops APU (APU enters idle H { 
H | state). H \ 
| prspsneeigiriasiel arcing aang mae venenatis en aie ee | 
| X'86' | NO-OP - APU sends its status | None | 
; only. | } 
| a a eer ee 
| X'89' | Fetch APU error code. | Reserved for diagnostic 
i use. 
[pees eens Sees See SSeS eS SSeS Sas eee See Sa See ore See See Se 
i X'8A' {| Checkpoint task state saves | APU must have a current H 
H { context of current task. { task. { 
H i Task continues execution if H ; 
H } previously running or remains | { 
| idle if previously idle. H 
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NOTE 


An undefined command code in the SV13.DOP 
field is sent to the APU without 0S/32 
intervention. The APU identifies the 
code sent as an unrecognizable command 
code or aS a sequence error. For more 
information on the SVC13 APU commands, 
see the Model 3200MPS System Instruction 
Set Reference Manual. 


10.6 SVC13 AUXILIARY PROCESSING UNIT (APU) HARDWARE STATUS 
FIELD (SV13.APS) 


After execution of SVC13 code 1 option xX'80' or SVC13 code 3 
option xX'08', the status of the APU hardware is saved in the APU 
status (SV13.APS) field of the parameter block. This field 
consists of two bytes, a response byte and an error code byte, 
representing the response and error fields of the program status 
word (PSW). The hardware status is returned to this field in the 
format shown in Figure 10-12. See Table 10-8 for the response 
byte bit definitions. Error codes returned to the error code 
byte are listed in Table 10-9. See the Model 3200MPS System 
Instruction Set Reference Manual for more information. 


RESPONSE BYTE ERROR CODE BYTE 

; Pi Rf ;wiRiE;}MiM j 
i; AitU i NON- | Af} BE}; RYO} O |} 
'RiN } i r}s | R}DtiOD 4} ERROR H CODE ' 

| TASK {| T}P;{;Oj;214; 2°} 

; R |} | 
Bits: 

0 7 8 15 


Figure 10-12 APU Hardware Response Byte (SV13.APS) 
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TABLE 10-8 APU HARDWARE RESPONSE BYTE/BIT DEFINITIONS 


BIT 
POSITION | BIT NAME | BIT SETTING AND MEANING 
| l= ensures that the response byte has 
an odd parity. 
t 
! 


O= odd number of bits have been set for 
the remainder of the byte. 

} l= APU is running. 

} O= APU is idle. 

NONTASK ; l= current PSW bit 15 is set, indicat- 

ing no context save area is 

H available. 

| O= APU executing a task; the current 

’ 

| 

| 

\ 


: 


PSW bit 15 is not set, indicating 
that the current task's context save 
area is ready to receive the 
processor task state. 

;} l= current PSW bit 16 is set, indicat- 
ing APU is in a wait state or APU is 
working in an internal service state 
| (e.g., scheduling a task). 
! 
U 


meee ee ewe ee ee 


O= current PSW bit 16 is not set, 
indicating the APU is executing 
instructions. 

l= APU is responding to a command from 
the CPU. 

O= APU is generating a signal indi- 
cating a change in APU function. 

| l= APU detects an error condition that 

H causes the APU to stop; the error 

condition is indicated by the set- 

ting of the error code bit (see 

! 

: 

H 


——_ eee ee ee ee ee 
en ween wee eee eee eee owe 


Table 10-9). 
O= no error condition is detected by 
APU. 
Bit definitions for MOD1 and MOD2 
depend on the definitions for RESP and 
ERROR, as follows: 


RESP=0, ERROR=0 


00 = undefined 
Ol = APU entering queue wait state 
10 = task rescheduled to APU ready 


queue 
ll = task rescheduled to CPU 
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TABLE 10-8 APU HARDWARE RESPONSE BYTE/BIT DEFINITIONS 


(Continued) 
BIT 
| POSITION BIT NAME } BIT SETTING AND MEANING 
; te SFC SoOS Sar rst SESE SKS STRV SBMS TET SPST KO ST SSSI SEM ETEK SKS SFT Ker sc SSS SS H 
6,7 | RESP=0, ERROR=1 
(cont'd) 
00 = general error status 
Ol = error occurred while APU in 
queue wait state 
10 = error occurred while locking 
queue 
ll = undefined 


RESP=1, ERROR=0 


Ol = task is waiting on APU queue 
10 = APU attempting to lock a queue 
ll = command sequence error; command 


was ignored 


general response status 
' 

! 

! 

t 

RESP=1, ERROR=1 
( 

! 

| 

H 

i 


oO 
oO 


00 = error as a result of command 

Ol = response, error in queue wait 

10 = response, error in queue lock 

ll = error and command sequence error 


NOTE 


See the Model 3200MPS System Instruction 
Set Reference Manual for more information 
on the nontask and wait states that 
reflect the PSW bit definitions. 


TABLE 10-9 ERROR CODES FOR ERROR CODE BYTE OF APU 
HARDWARE STATUS FIELD (SV13.APS) 


X'02' 
X'83' 


ZERO APUID RETURNED BY RTSM 
CAN'T FETCH WORD @ X'C4' - ECC 


| ERROR } 
| CODE } MEAN ING 
| Ser_rEF RESCH R ESI SSK ESET SES EE RREAISSEAS SSS SS BSseSeS SSeS SS = H 
| X'8O0' No error H 
i X'OO' No response from the APU 


1 
{ 
X'O1' | APUID DEVICE FALSE SYNC 
| 
! 
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TABLE 10-9 ERROR CODES FOR ERROR CODE BYTE OF APU 


HARDWARE STATUS F [ELD (SV13.APS) 
(Continued) 


MEANING 
APUID > MAX APU @ X'C7! 
BAD A(APB_DIR) - ECC/ZERO/ALIGN 
BAD A(APB) - ECC/ZERO/ALIGN 
BAD APB (FLAGS:APB#) WORD - ECC 


WRONG APB# IN APB 

APB PASSBACK 

UNRECOGNIZED COMMAND 

BAD APB A(CTCB) - ECC/ZERO/ALIGN 


BAD A (APU TCB QUEUE) - ECC/ZERO/ALIGN 
QUEUE LOCK TIMEOUT 

EXECUTION SUSPENDED (TRAP PSW WAIT) 
BAD SSTD - ECC 


CAN'T LOAD TASK CONTEXT 
CAN'T STORE TASK CONTEXT 
CAN'T LOAD PWR FAIL IMAGE 
CAN'T STORE POWER FAIL IMAGE 


CAN'T LOAD PSTD - ECC 

BAD APB PFAIL PTR - ECC/ZERO 

BAD APB MMF NEW PSW - PCC/ZERO 
BAD CTCB CTX PTR - ECC/ZERO/ALIGN 


BAD APB TCB CNT WORK - ECC 

BAD A(APU FRONT TCB) - ECC/ZERO/ALIGN 
FRONT TCB PTR< TCB CNT DISAGREE 

QUEUE TCB CNT UNDERFLOW 


BAD APB A(CPU QUEUE) - ECC/ZERO/ALIGN 
BAD TCB QHPTR - ECC/ZERO/ALIGN 
INCORRECT TCB QUEUE HEAD PTR 

BAD TCB BPTR - ECC/ZERO/ALIGN 


BAD BACK TCB FPTR - ECC/ZERO/ALIGN 
BACK TCB FPTR NOT TO FRONT TCB 

BAD FRONT TCB FPTR - ECC/ZERO/ALIGN 
BAD FWD TCB BPTR - ECC/ZERO/ALIGN 


FWD TCB BPTR NOT TO FRONT TCB 

INCONSISTENT FRONT TCB FPTR & BPTR 
BAD FRONT TCB PTR - ECC/ZERO/ALIGN 
BAD BACK TCB FPTR - ECC/ZERO/ALIGN 
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TABLE 10-9 ERROR CODES FOR ERROR CODE BYTE OF APU 
HARDWARE STATUS F TELD (SV13 .APS) 


(Cont inued) 
| ERROR } { 
| CODE | MEAN [NG { 
| cer act SSS SF SSP SS ESBAIRE SEO BRERA E SCR TKK SS SSK SKE S AT ses SS \ 
| X'A8' | BACK TCB'S FPTR NOT TO FRONT TCB 
| X'29' | TCB QUEUE OVERFLOW (CPU OR APU) | 
| X'2A' | BAD MSH TIME ACCUMULATOR - ECC 
; X'AB' {| BAD LSH TIME ACCUMULATOR - ECC 
I | ] 
( t | 
i X'2C' | BAD TCB START TIME WORD - ECC 
| X'AD' | CAN'T READ RTSM CLOCK DATA 
| X'AE' | TCB ELAPSED TIME OVERFLOW 
| X'2F' | TCB "PENDING" FLAGS SET ON QUEUE OR CTCB | 
’ ! ! 
{ ! ' 
| X'BO' | BAD "PENDING" FLAGS WORD - ECC 
{ X'31' | INTERRUPT FROM RTSM XMTR 
| X'32' | CAN'T LOAD PFAIL PSTD - ECC 
| X'B3"' {| CAN'T LOAD PFAIL SSTD - ECC 
i 1 ] 
t { ' 
| X'B4" | BAD APB MSH TASK TIME ACC - ECC | 
| X'B5" | BAD APB LSH TASK TIME ACC - ECC 1 
{| X'B6" | WRONG LAST APUID IN CTCB 


10.7 SVC13 ERROR STATUS CODE FIELD (SV13.ERR) 


When execution of SVC13 is completed, the execution status is 
returned to the error status code (SV13.ERR) field of the 
parameter block. If no error occurs, a value of 0 is stored in 
this field. If SVC13 code 1, 2 or 3 is issued and an error 
occurs, the first byte of this field contains the bit position of 
the option that caused the error. 


Table 10-10 lists the SVC13 error status codes and their 
applicable function codes. 
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TABLE 10-10 SVC13 ERROR STATUS CODES (SV13.ERR) 


| APPLICABLE |} 
| STATUS | FUNCTION | H 
| CODE } CODES MEAN ING 
0 All | No errors occurred. 
ataetatatatatatatatatan nepetatattatatatataneiatectatetataicans Iai iedeietatanenaiaiata tata | 
1 All | The specified data buffer does not 
| begin on a fullword boundary. 
| ann nnn nnn nn nn nnn nnn nnn enn nnn anno nae nna enaannn | 
2 0,1 | The specified data buffer is not locat- | 
| e@ in a writable segment of the task. 
stay een aa clatatn sci ara ccna Pete omen a Rien me CR ER a ! 
H 3 H All | Insufficient space was available in the | 
} Supplied data buffer. For functions 0 } 
| and 1, any data that does not fit in 
| the available space is lost. 
eo as an ce aa als Gua a a ag ore PRE SEE A I + 
i 4 2S | Task establishment options prohibit the | 
|} task from gaining mapping or control 
| | rights. 
Ire a ee ee nee oe | 
5 2,3 | Task has not been granted the rights to } 
| perform the attempted mapping or 
} control function. 
(ea siceine aise sais sg ecco tes oa ae ae cs eG ae ee 
6 | Ll option j; The APU number specified is greater 
: X'80',3 i than the maximum allowed. 
[a ee ee ! 
7 | 2 option ; The LPU number specified is greater 
x'10' | than the maximum allowed. 
oe ee ae SSS aa ee eee aaa eS eee eee Sere SS sas 
8 i 1,2,3 | An invalid option was specified for 
| this function. 
Pa eS eS ea eae a a a ree ee no eee 
9 2,3 | The requested privilege is currently 
| held by another task and cannot be 
| granted. 
Se aa ee a Se eee | 
10 2 |} The specified queue cannot be marked 
H H } ON-exclusive from an ON state. i 
ee a aaa eee ae Rae ae See a ee ere eS 
11 3 | The function requested cannot be 
| completed because the specified APU is j} 
i in a DISABLED state. 
eae ginma rca muny sans ae oe H5 € Gre ane oe ER See CaS | 
12 | lL option | Access to the APU queue could not be 
; X'40', 2, | obtained; SVC13 request aborted. ! 
| 3 option { 
i X'O04' 
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TABLE 10-10 SVC13 ERROR STATUS CODES (SV13.ERR) (Continued) 
| APPLICABLE | 
| STATUS | FUNCTION | 
| CODE | CODES MEAN ING 
| SRR RRR SSS SR ESS SE RE SRE REE eee eee ees eee | 
13 ; 2 option ; The task has not been granted mapping 
X'10' | rights over the APU queue to which the } 
| specified APU is currently mapped. 
[SSS Sear eS SSS aa era Sea te ee ea ea ee eee 
14 | 3 option | Cannot enable APU unless in a DISABLED jj; 
X'40' | state. 
Scere eta acces ai ieee aR ER RC eas 
15 i 3 option { APU could not pass power-up link chec 
X'40' ; sequence. APU left in disabled state. | 
[Pee ees ree Se ease ea a awe ee ee en ee ea ee ee eT 
16 i 3 option | Cannot disable APU unless in an ENABLED ; 
X'02' | state. } 
I ns areaoigtan esi es aacitea gibson tos d= ela a eR IS | 
17 i 2 option | The APU could not be marked ON- 
X'40' | exclusive because the specified task 
{ could not be found in the system. 
[ere ae See aaa ae ee ees eee a ee ee 
18 | 3 option j| Error encountered in transmission of 
X'08' | the specified control command. 
(Sa = ee eS aa ee ea ee eee eee ae 
19 i 3 option j; The preemptive task could not be found jj; 
x'10' | on the specified APU ready queue. The } 
H | APU queue is unchanged. 
a an a aad a a a a 
H 20 | 3 option |; The preemptive task is not on a no- 
X'10' | priority queue to which a single APU is } 
| assigned. The queue is unchanged. } 
Kean canis seein eercaminga ie aeiaan oie emake Gcae a earn mas sara ! 
21 | 1 option | The queue number specified is greater 
X'40',2 {| than the maximum allowed. H 
| 3 option § | 
X'04' 
Pa Pe ie ee eee ee ee ee er re eee ee 
22 H 2 | The specified option is not applicable jj; 
H H | to queue O to which the mapping } 
H H i} function is directed. H 
ae aaa a ca i aaa ee Aa i can al 
23 i 2 option | The queue discipline specified is 
x'04' | undefined. 
| wt nr nnn nn nnn nnn nnn nnn nnn nnn maaan 
24 } 2 option j| The queue cannot be marked ON-exclusive | 
H H x'40' | because more than one APU is currently | 
i | } assigned to it. } 
[Pee ae ee Se SSS rn SR eee Sere ee ee ere eS eS 
: 25 H 3 | No response from APU. 


a A A ES TS A a OO SD SD SN TE US ce a mee er eS carne SG wa erm Ne Ee em SD eee ee te ee SS ee ey on 
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10.8 TYPICAL OPTION CODING SEQUENCES FOR SVC13 CODE 2 AND 
CODE 3 


The options field (SV13.OPT) in the SVC13 parameter blocks’ for 
codes 2 and 3 allows the user to issue one call to execute 
multiple APU mapping or control functions. Multiple options are 
executed from left-to-right. Care must be taken when selecting 
the sequence of options to perform a designated mapping or 
control function. The following sections demonstrate specific 
option coding sequences that would be used by a typical APU 
control task in a Model 3200MPS System. 


10.8.1 Auxiliary Processing Unit (APU) Initialization and 
Start-Up 


Before a task can run on an APU, the APU must be initialized and 
started for task execution. This is accomplished through an 
SVC13 code 3 with the following sequence of option codes 
specified: 


OPTION 

CODES FUNCTIONS PERFORMED 

X'80' Gain control rights for task. 

X'40' Enable (initialize) APU. 

X'08! Send APU start directive (X'O1') specified in 
SV13.DOP field. 

X'O1' Release control rights. 


At system start-up, the APU is assigned toa queue with the’ same 
number as that of the APU. The queue is defined as no-priority. 


10.8.2 Auxiliary Processing Unit (APU) Queue Mark On 


Before a task can be scheduled to an APU queue, the queue must be 
activated and the task's LPU mapped to it. This is accomplished 
through an SVC13 code 2 with the following sequence of option 
codes specified: 


OPTION 

CODES FUNCTIONS PERFORMED 
X'80' Gain mapping rights for task. 
X'20' Mark APU queue on. 

X'10' Map LPU to the queue. 

X'O1' Release mapping rights. 
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If the APU is to be marked on exclusively for one task, 
following option coding sequence is used for SVC13 code 2: 


OPTION 

CODES FUNCTIONS PERFORMED 
X'80' Gain mapping rights for task. 
X'40' Mark APU queue ON-exclusive. 
x'10' Map LPU to the queue. 

X'OL' Release mapping rights. 


the 


10.8.3 Setting Auxiliary Processing Unit (APU) Queue Discipline 


To change the existing queue discipline definition, use 


OPTION 

CODES FUNCTIONS PERFORMED 
X'80' Gain mapping rights for task. 
X'40' Set queue discipline. 

X'O1' Release mapping rights. 


10.8.4 Assigning Auxiliary Processing Unit (APU) to a Queue 


To change the existing APU assignment, use SVC13 code 3 with 
following sequence of option codes specified: 


OPTION 

CODES FUNCTIONS PERFORMED 
X'80' ain control rights for task. 
X'04' Assign APU to queue. 

X'O1' Release control rights. 


10.8.5 Task Scheduling on the Auxiliary Processing Unit (APU) 


Normally, tasks are executed according to queue discipline 


SVC13 
code 2 with the following sequence of option codes specified: 


the 


and 


task priority. Consequently, it is possible to control the order 
of task execution on an APU priority or priority-enforced queue 


by changing task priorities through SVC6 mechanisms. 
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When minimal task context switch time is desired, a no-priority 
Giscipline can be used. Controlling the order of task execution 
on the APU no-priority queue may be accomplished by preempting 
(stopping) the current active task, rescheduling the task to the 
rear of the queue, and 


@e selecting the next task from the front of the queue for 
execution or 
@® selecting a task (by name) on the queue for execution. 


To schedule the current task to the rear of the queue, use SVC13 
code 3 with the following sequence of option codes specified: 


OPTION 

CODES FUNCTIONS PERFORMED 

X'80' Gain control rights for task. 

X'20' Stop APU task execution and reschedule current task 
to rear of the queue. 

X'O08! Send APU start directive (X'01') specified in 
SV13.DOP field to select the task at the front of 
the APU ready queue for execution. 

X'O1' Release control rights. 


To preempt the next ready task, thereby explicitly selecting the 
next task to be run, use SVC13 code 3 with the following sequence 
of option codes specified: 


OPTION 

CODES FUNCTIONS PERFORMED 

X'80' Gain control rights for task. 

X'20' Stop APU task execution and reschedule current task 
to rear of the queue. 

X'10! Select designated task on the queve (changing the 
pointer in the task queue head to point to the 
task). 

X'08'! Send APU start directive (X'0O1') specified in 
SV13.DOP field to start task. 

X'OL' Release control rights. 
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10.8.6 Auxiliary Processing Unit (APU) Queue Mark Off 


An APU) queue can be marked off with or without remapping 
respective LPUs. To mark off an APU queue without remapping, use 
SVC13 code 2 with the following sequence of option codes 
specified: 


OPTION 

CODES FUNCTIONS PERFORMED 
X'80' Gain mapping rights for task. 
X'02' Mark queue off. 

X'O1' Release mapping rights. 


To mark an APU queue off and remap respective LPUs to queue 0, 
use SVC13 code 2 with the following sequence of option codes 
specified: 


OPTION 

CODES FUNCTIONS PERFORMED 
x'80' Gain mapping rights for task. 
xX'08! Map queue's LPUs to queue 0. 
X'O2' Mark queue off. 

X'O1' Release mapping rights. 
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CHAPTER 11 
USER SUPERVISOR CALL 14 (SVC14) 


11.1 SVC14: USER 


SVC14 gives a user-written task a means of accepting an SVC from 
a part of itself; e.g., a subroutine or other module. 


Format: 
SVC 14,A(X2) or RX1,RX2 FORMATS 
SVC 14,A(FX2,SX2) RX3 FORMAT 


The address field of SVC14 is not interpreted by O0S/32 but can be 
defined by the task. Normally, it might be used to point to a 
parameter block. 


If the user SVC trap enable bit in the current task status word 
(TSW) is enabled, SVC1l4 is enabled; otherwise, SvVC14 is 
considered an illegal SVC. 


When SVC14 is executed, the operating system stores the effective 
program address of the SVC1l4 second argument into the Svcl14 
address pointer location in the task user-dedicated location 
(UDL). A TSW swap then occurs, using the SVC14 TSW swap area _ in 
the UDL. The interpretation of this SVC is then left to the 
user. The effective program address is calculated as for an RXI1, 
RX2 or RX3 instruction. This facility permits the user to build 
a virtual executive task (e-task) within a single task 
environment. 


OS/32 AIDS, the OS/32 debugging utility, makes use of SVC14; 
consequently, a task should not use SVC14 while the OS/32 AIDS 
software is in operation. 


See the 0S/32 Application Level Programmer Reference Manual _ for 
more information on enabling and handling SVC14 task traps. 
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CHAPTER 12 
DATA COMMUNICATIONS DEVICE-DEPENDENT INPUT/OUTPUT (1/0) 
SUPERVISOR CALL 15 (SVC15) 


12.1 SVC15: DATA COMMUNICATIONS DEVICE-DEPENDENT INPUT/OUTPUT 
(1/0) 


SVC15 allows a user-written task to access data communications 
devices at the device-dependent. level. See the OS/32 Basic Data 
Communications Reference Manual for more information. 
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A 
Access privileges 
APU 


assigning a queue 

byte bit definitions 
commands 

control options 

error codes 

error status codes 
function codes 

hardware status field 
initialization and 
start-up 

mapping functions 


mapping options field 
option coding sequences 
processing status field 
queue mark off 
queue mark on 
queue processing status 
field 
setting queue discipline 
task scheduling 
Arithmetic fault 
fixed point division by 0 
fixed point quotient 
overflow 
floating point division 
by 0 
floating point 
overf low/underf low 
interrupt 
ASCII decimal to binary 
conversion 
ASCII hexadecimal to binary 
conversion 
Auxiliary processing unit. 
See APU. 


Bare disk 
assignment 
devices 
Buffer 
full bit 
length of last buffer 
start/buffer end address 
Buffer queue, using 


Calling task 

Central processing unit. 
See CPU. 

CMDLENGTH option 

Command function requests 
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10-1 
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10-34 
10-16 
10-16 
10-19 
10-34 
10-11 
10-37 
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10-35 
10-35 
3-19 
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3-19 
3-17 


3-53 
3=53 
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Conditional proceed 
CPU 

model numbers 
CTOP 


D 


Data communications access 
methods 
definitions 
Data transfer requests 
function code bit 
positions 
function code format 
Device-dependent status 
Device-independent status 


E 


Extended function codes 
control operations 
Gata transfer operations 
Extended options 
communication dependent 
dev ice-dependent 
dev ice~ independent 
field 
local and remote 
communications 
nonmagnetic tape devices 


F 


File size field (SVC7.SIZ) 
File types 
contiguous 
data communications 
buffered-terminal manager 
extendable contiguous 
indexed 
long record 
nonbuffered indexed 
Function codes 
data transfer requests 
Gata transfer requests, 
gapless 
general service functions 
I/O bus switch driver 


G 


Gapless I/O operations 
buffer queues 
device-dependent status 

codes 
device-independent 
status codes 


2-26 
2-28 
2-21 
2-22 
2-22 
2=22 
2-43 


2-23 
2-22 


7-32 
7-30 


7-30 
7-30 
7-30 
7-30 
7-30 
2-18 
2-5 


2-36 


3-1 
2-46 


2-33 
2-40 


2-39 


2-39 


IND-1 


Gapless I/O operations 
(Cont inued) 
trap-causing events 

Gapless mode 
parameter block format 


Halt 1/0 


I,J,K 


I/O bus switch 
driver 
master request 
contention mode 
multiple master request 
contention mode 
normal request 
contention mode 
programming 
considerations 
Series 3200 
I/O proceed 
IN-QUEUE 


Input/output. See I/0. 


L 


Logical processing units. 
See LPUs. 
Logical unit. 

LPUs 

lu 


See lu. 


M 


Magnetic tape devices 
MASTER CONNECT 
Multiple buffer chain 


N 


NACPRIVILEGE option 
Nonmagnetic tape devices 


O,P 


Options 
APU control 
APU mapping 
CMDLENGTH 
coding sequences 
extended 
extended load 
from the SPT 
NACPRIVILEGE 
privileged task 
start 


2-42 
2-33 


2-46 
2-44 
2-44 
2-44 


2-48 
2-44 
2-14 
2-33 


10-23 

10-19 
6-43 

10-34 
2-21 
6-14 
3-106 
7-5 
3-80 
6-43 


Options (Continued) 
XSVCl Link 
OUT-QUEUE 
Q 


Queuing 1/0 requests 


R 

Read APU 

assignment and mapping 

information 

Read APU/APU queue status 
Read key 
Read/write key fields 
RTL 


Run-time library. See RTL. 


Set status 
Single buffer chain 
Single buffer ring 
Software enabling of manual 
density selection 
SPT 
system options 
Standard function code 
gapless 
Status codes 
dev ice-dependent 
dev ice-dependent 
(magnetic tape) 
dev ice-independent 
I/O bus switch 
mag tape 
device-dependent, gapless 
magnetic tape 
dev ice-dependent 
Supervisor call. See SVC. 
SVC 
error messages 
status codes 
SvcO: user-written SVC 
SVCl: I/O requests 
data transfer requests 
gapless I/O operations 
SVC2: function codes 
SVC2: general services 


SVC2 code 0: make journal 
entries 
SVC2 code 1: pause 
SVC2 code 2: get storage 
option X'00' 
option X'80' 
SVC2 code 3: release storage 
SVC2 code 4: set status 
option X'00' 
option X'80' 
SVC2 code 5: fetch pointer 


SVC2 code 6: convert binary 
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to ASCII 
option X'40'+n 
option X'80'+n 
option X'CO'+n 
SVC2 code 7: log message 
option x'00' 
option X'20' 
option X'40! 
option X'60' 
option X'80' 
option X'AO' 
option X'CO0' 
option X'EO! 
SVC2 code 8: interrogate 
clock 
option X'00' 
option X'40' 
option x'80' 
option X'CO' 
SVC2 code 9: fetch date 
SVC2 code 10: time of day 
wait 
SVC2 code 1l: 
SVC2 code 14: 
option 0 
option 1 
programming 
considerations 
status codes 
SVC2 code 15: convert ASCII 
to binary 
option x'0do' 
option X'40' 
option X'80' 
option X'COo' 
SVC2 code 16: pack file 
descriptor 
descriptor area 
option x'G0' 
option X'10' 
option xX'20' 
option x'40' 
option X'50' 
option X's0' 
privileged task options 
SVC2 code 17: scan mnemonic 
table 
building a table 
execution of 
SVC2 code 18: move ASCII 
characters 
option x'00'+n 
option X'80'+n 
SVC2 code 19: peek 
option x'dd' 
option Xx'0l' 
option X'd2' 
option X'Q3' 
option X'04' 
task options from TCB 
task wait status bit 
definitions 


interval wait 
internal reader 


SVC2 code 20: expand 
allocation 

SVC2 code 21: contract 
allocation 
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3-24 
3-26 
3-27 
3-27 
3-28 
3-30 
3-31 
3-31 
3-31 
3-31 
3-32 
3-33 
3-33 


3-34 
3-35 
3-37 
3-36 
3-37 
3-39 


3-42 
3-45 


3-47 
3-49 


3-51 
3-51 


3-53 
3-54 
3-56 
3-57 
3-59 


3-60 
3-63 
3-69 
3771 
3-73 
3-70 
3-73 
3-76 
3-80 


3-82 
3-84 
3-84 


3-90 
3-92 
3-93 


3-98 

3-104 
3-110 
3-112 
3-118 
3-100 


3-116 
3-121 
3-123 


SVC2 code 23: 
management 
option xX'00' 
- option X'10' 
option X'20' 
option xX'40' 
option X'80' 
SVC2 code 24: set accounting 
information 
SVC2 code 25: fetch 
accounting information 
fixed-size 
variable size 
SVC2 code 26: fetch device 
name 
SVC2 code 27: memory 
management 
SVC2 code 29: unpack file 
descriptor 


timer 


SVC3: end of task 
SVC5: fetch overlay 
SVC6: error codes 


SvC6: functions 
assign LPU (SFUN.LPU) 
change priority (SFUN.PM) 
connect (SFUN.OM) 
delay start function 
(SFUN.SDM) 
delay start options 
(SFUN.SDM, SFUN.SOM) 
direction (SFUN.DOM, 
SFUN.DSM) 
end task (SFUN.ECM, 
SFUN.EDM) 
freeze (SFUN.FM) 
load task 
load task (SFUN.LM) 
nonresident (SFUN.NM) 
nonrollable (SFUN.NRM) 
queue parameter (SFUN.QM) 
receive lu (SFUN.XRM) 
release (SFUN.RM) 
rollable (SFUN. RLM) 
send data (SFUN.DM) 
send lu (SFUN.XSM) 
send message (SFUN.MM) 
sint (SFUN. IM) 
start (bit positions 29, 
30, 31) 
start function (SFUN.SIM) 
start options (SFUN.SOM) 
suspend (SFUN.SM) 
task resident (SFUN.HM) 
thaw (SFUN.TM) 
transfer to CPU (SFUN.TC) 
transfer to LPU (SFUN.TL) 
unconnect (SFUN.UM) 
Svc6: intertask 
communications 
error codes 
error codes (SVC6.STA) 
extended load options 
free send message for 
receiving task 
function code (SVC6.FUN) 
function code field 


3-124 
3-135 
3-133 
3-129 
3-127 


3-138 


3-140 
3-141 
3-142 


3-143 
3-145 


3-148 
4-1 
o=1 
6--46 


6-39 
6-35 
6-36 


6-43 
6-44 
6-10 


6-10 
6-38 
6-11 
6-12 
6-41 
6-42 
6-34 
6-36 
6-41 
6-41 
6-17 


“6-35 


6-25 
6-37 


6-42 
6-43 
6-43 
6-17 
6-16 
6-37 
6-40 
6-39 
6-38 


6-1 

6-46 
6-45 
6-14 


6-19 


6-5 
6-7 
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message buffers 
multiple buffer chain 
multiple buffer ring 
send message for calling 
task 
send message for 
directed task 
send message for sending 
task 
wait status bit 
definitions 
wait status field 
(SVC6.TST) 
SVC7 code 0: fetch 
attribute/bare disk devices 
SVC7 code X'FF80': extended 
close function 
SvC7: file handling services 
access privileges 
bare disk assignment 
change terminal mode 
SVC7: file handling services 
data communications 
access methods 
device attributes field 
device rename 
device reprotect 
error codes 
file size (SVC7.SIZ) 
function code (SVC7.OPT) 
privileged tasks 
read/write key fields 
SVvC7: functions 
allocate 
assign 
assign to pseudo device 
change access privileges 
checkpoint 
close 
delete 
extended assign to 
spoolfile 
extended close 
fetch attributes 
fetch logical attributes 
fetch time and date 
attributes 
rename 
reprotect 
spoolfile assign to 
pseudo device 
temporary file 
allocation/assignment 
VFC 
SVC9: load TSW 
SVC10: overlay loading 
error codes and meanings 
messages 
SVC13: APU services 
APU byte/bit definitions 
APU control options 
APU hardware status 
(SV13.APS) 
APU mapping options 
field (SVC13.0OPT) 
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APU processing status 

APU queue mark off 

APU queue processing 
status 

assigning APU to a queue 

bit definitions/APU 
options 


SVC13: APU services 
bit definitions/APU 


processing status 
code 0 
code 1 
code 2: APU mapping 
functions 
code 3: APU commands 
(SV13 .DOP) 


code 3: APU control 
error codes for hardware 
status 
error status codes 
(SV13 .ERR) 
function codes 
initialization and 
start-up 
queue mark on 
setting APU queue 
discipline 
task scheduling on an APU 
typical option coding 
SvCl14: user 
SVC15: device-dependent I/0 
System macro library 
utility commands 
System pointer table. See 
SPT. 


- 


Task control block. 
Task scheduling APU 
zack status word. See TSW. 
T 


See TCB. 


TEMPFILE command 
Test and set 
TSW 


bit definitions 
function and description 


UBOT 

Unconditional proceed 
User SVC14 

UTOP 
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10-11 
10-37 


10-14 
10-35 


10-12 


10-11 
10-15 
10-2 
10-5 


10-16 


10-25 
10-20 


10-29 


10-32 
10-1 


10-34 
10-34 


10-35 
10-35 
10-34 
Lia2 
12-1 
1-3 
1-4 


3>21 

2-16 
li-1 

3-10 


FOO RO2 


Vv 


Vertical forms control. See 


VFC. 
VFC 7-12 
W 

Wait 1/0 2-16 
device-dependent status 2-20 
device-independent status 2-19 
extended options 2-21 

Wait only 2-17 

Write key 7-3 

X,¥,Z 
XSVCl Link option 2-33 
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